Skip to content

Graph-Native Infrastructure for Context and Accountable AI Systems

docs(index): cut marketing copy, remove em dashes, make crisp (#1421)

Mohd Kaif40efab67968d
diff --git a/docs/docs.json b/docs/docs.json
index 6f68faad..7eb7b1b0 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -2,7 +2,7 @@
"$schema": "https://mintlify.com/docs.json",
"theme": "mint",
"name": "Semantica",
- "description": "The Accountability and Context Layer for AI — Context Graphs · Decision Intelligence · Full Provenance",
+ "description": "The Context and Semantic Layer for AI in High-Stakes Domains — Context Graphs · Decision Intelligence · Full Provenance",
"colors": {
"primary": "#10B981",
"light": "#10B981",
@@ -43,7 +43,7 @@
"raiseIssue": true
},
"metadata": {
- "og:title": "Semantica — Accountability & Context Layer for AI",
+ "og:title": "Semantica — Context & Semantic Layer for AI in High-Stakes Domains",
"og:description": "Build explainable, auditable knowledge graphs with full provenance. Open source. MIT licensed.",
"og:image": "/assets/img/semantica-logo.png",
"twitter:card": "summary_large_image",
diff --git a/docs/index.md b/docs/index.md
index ce6ffb07..e15cabd5 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,97 +1,87 @@
---
title: "Semantica"
-description: "The Accountability and Context Layer for AI: Context Graphs · Decision Intelligence · Full Provenance"
+description: "The Context and Semantic Layer for AI in High-Stakes Domains: Context Graphs · Decision Intelligence · Full Provenance"
---
```bash
pip install semantica
```
-Your AI agent just made a decision. Now someone needs to explain it.
+Most AI agents store embeddings, not meaning. They can't say why a fact was recalled, where it came from, or what led to a decision. In healthcare, finance, legal, and government, that lack of a traceable record blocks production deployment.
-*What did it know at the time? Which facts shaped the outcome? Where did those facts come from? Has it made the same call before: and did that go well?*
+Semantica is the context and semantic layer for AI in high-stakes domains, sitting beneath your existing agent framework. It doesn't replace LangChain or LlamaIndex; it makes their outputs traceable.
-If your stack can't answer those questions with a traceable record, you have a gap. Not a capability gap: an **accountability gap**. It's the reason AI hasn't landed at scale in healthcare, finance, legal, and government. And it's why teams building for those markets keep rebuilding the same guardrails from scratch.
-**Semantica closes that gap.** It's the context and accountability layer that sits beneath your existing agent framework: not a replacement for LangChain or LlamaIndex, but the infrastructure that makes their outputs trustworthy.
+## What Most AI Stacks Are Missing
-
-## The Problem Every Production AI Team Hits
-
-Powerful agents aren't automatically trustworthy ones. Five structural blind spots make modern AI systems impossible to deploy in regulated environments:
-
-**No memory structure** — agents store embeddings, not meaning
+**No memory structure.** Agents store embeddings, not meaning.
- No way to ask *why* a fact was recalled
- No link from a recalled fact back to its source document
- Context is a black box that resets on every run
-**No decision trail** — agents act continuously but record nothing
+**No decision trail.** Agents act continuously but record nothing.
- No history to hand to a regulator or auditor
- No way to replay or reproduce a past decision
- Debugging means re-running, not reviewing
-**No provenance** — outputs can't be traced to source facts
-- In healthcare, finance, and legal: this is a hard compliance blocker
+**No provenance.** Outputs can't be traced to source facts.
+- A hard compliance blocker in healthcare, finance, and legal
- No lineage from inference back to the original document
-- Impossible to demonstrate what the agent actually relied on
+- No way to demonstrate what the agent actually relied on
-**No reasoning transparency** — black-box answers with no explanation
-- Impossible to validate the reasoning path
-- Impossible to contest a specific conclusion
+**No reasoning transparency.** Black-box answers with no explanation.
+- No way to validate the reasoning path
+- No way to contest a specific conclusion
- No basis for improving or correcting future behavior
-**No conflict detection** — contradictory facts silently coexist in vector stores
+**No conflict detection.** Contradictory facts silently coexist in vector stores.
- No detection when two sources disagree
- Outputs become inconsistent and unpredictable over time
- Silent failures compound as the knowledge base grows
-<Note>
- These aren't edge cases. They're why enterprise AI pilots stall: and why your compliance team keeps saying *not yet*.
-</Note>
-
## What Semantica Adds to Your Stack
-Semantica gives every agent the infrastructure it needs to be accountable. Drop it into your existing setup in minutes:
+Semantica gives every agent the infrastructure it needs to be accountable, and it drops into an existing setup in minutes.
-**Context Graphs** — a structured, queryable graph of everything your agent knows, decides, and reasons about
-- Persistent across agent runs: no context loss between sessions
+**Context Graphs.** A structured, queryable graph of everything your agent knows, decides, and reasons about.
+- Persistent across agent runs, with no context loss between sessions
- Queryable with SPARQL and full graph algorithms
- Temporal model with `valid_from` / `valid_until` on nodes and edges
- Point-in-time snapshots of the full knowledge state
-**Decision Intelligence** — every decision is a first-class object in your system
+**Decision Intelligence.** Every decision is a first-class object in your system.
- `record_decision()` captures full lifecycle and causal chain
- Hybrid precedent search over past decisions for consistency
- `analyze_decision_impact()` shows downstream consequences
- Causal chain visualization from trigger to outcome
-**Full Provenance** — every fact links to its source document and ingestion event
+**Full Provenance.** Every fact links to its source document and ingestion event.
- W3C PROV-O compliant lineage across all modules
- Full traceability from raw input to final inference
- `recorded_at` stamping with OWL-Time export
- Audit-ready for HIPAA, SOX, GDPR, FDA 21 CFR Part 11
-**Reasoning Engines** — explainable reasoning paths, not black boxes
+**Reasoning Engines.** Explainable reasoning paths, not black boxes.
- Forward chaining, Rete, deductive, abductive
- SPARQL query-based inference over RDF graphs
- Datalog with recursive Horn clause rules
- Every conclusion backed by a traceable derivation path
-**Temporal Intelligence** — your graph knows not just *what*, but *when*
-- Allen interval algebra: all 13 temporal relations
+**Temporal Intelligence.** Your graph knows not just *what*, but *when*.
+- Allen interval algebra covering all 13 temporal relations
- Point-in-time queries over historical graph states
- Temporal provenance stamping on every fact
- OWL-Time export for standards-compliant archiving
-**Ontology Hub** — full ontology lifecycle in the browser
+**Ontology Hub.** Full ontology lifecycle in the browser.
- Visual editor for schema design and editing
- SHACL Studio for constraint authoring and validation
- Alignment authoring across multiple ontologies
- Health dashboard and version control built in
<Tip>
- Works alongside any LLM provider and any agent framework: add it to an existing stack without changing your architecture.
+ Works alongside any LLM provider and any agent framework. Add it to an existing stack without changing your architecture.
</Tip>
<img src="/assets/img/diagrams/architecture-overview.svg" alt="Semantica four-layer architecture: Ingestion → Processing → Intelligence → Application" style={{ width: '100%', borderRadius: '12px', margin: '24px 0' }} />
@@ -185,17 +175,17 @@ decision_id = context.record_decision(
</CodeGroup>
-- [Full Quickstart](/quickstart) — Step-by-step pipeline walkthrough
-- [Cookbook](/cookbook) — 40+ real-world Jupyter notebooks
-- [Join Discord](https://discord.gg/sV34vps5hH) — Community chat and support
+- [Full Quickstart](/quickstart): step-by-step pipeline walkthrough
+- [Cookbook](/cookbook): 40+ real-world Jupyter notebooks
+- [Join Discord](https://discord.gg/sV34vps5hH): community chat and support
-## Built for Where Mistakes Have Consequences
+## Industry Use Cases
-Semantica was designed for domains where every decision must be explainable and every fact must be traceable.
+Semantica is used in domains where every decision must be explainable and every fact must be traceable.
<Warning>
- **This is system-level explainability, not foundation-model explainability.** Semantica does not expose, reconstruct, or explain what happens *inside* the LLM/foundation model — its internal reasoning or chain-of-thought stays opaque, as it does for any external system. What Semantica explains is *outside* the model: the context and data fed in, the decision produced, its provenance, the relevant relationships, the policies applied, and the full execution trail. See [Core Concepts](/concepts) for the full scope note.
+ **This is system-level explainability, not foundation-model explainability.** Semantica does not expose, reconstruct, or explain what happens *inside* the LLM/foundation model. Its internal reasoning or chain-of-thought stays opaque, as it does for any external system. What Semantica explains is *outside* the model: the context and data fed in, the decision produced, its provenance, the relevant relationships, the policies applied, and the full execution trail. See [Core Concepts](/concepts) for the full scope note.
</Warning>
**Healthcare & Life Sciences**
@@ -256,7 +246,7 @@ Semantica was designed for domains where every decision must be explainable and
- Knowledge graphs vs. vector stores: when to use each
- What GraphRAG is and how Semantica implements it
- How provenance and decision tracking work together
- - The accountability layer architecture
+ - The context and semantic layer architecture
</Step>
<Step title="Go deep on any module">
Every module has a dedicated [reference page](/reference/context) with:
@@ -266,12 +256,12 @@ Semantica was designed for domains where every decision must be explainable and
</Step>
</Steps>
-- [Installation](/installation) — Get Semantica installed in under a minute
-- [Quickstart](/quickstart) — Build a complete knowledge graph pipeline in 5 minutes
-- [Core Concepts](/concepts) — The mental model behind the API
-- [API Reference](/reference/context) — Exact module, class, and method details
-- [Cookbook](/cookbook) — Domain notebooks for real-world use cases
-- [Changelog](https://github.com/semantica-agi/semantica/releases) — Release history
+- [Installation](/installation): get Semantica installed in under a minute
+- [Quickstart](/quickstart): build a complete knowledge graph pipeline in 5 minutes
+- [Core Concepts](/concepts): the mental model behind the API
+- [API Reference](/reference/context): exact module, class, and method details
+- [Cookbook](/cookbook): domain notebooks for real-world use cases
+- [Changelog](https://github.com/semantica-agi/semantica/releases): release history
## Full Capabilities
@@ -394,20 +384,20 @@ Semantica was designed for domains where every decision must be explainable and
## Why Semantica?
-**Open Source, MIT** — No vendor lock-in. No paywalled features.
+**Open Source, MIT.** No vendor lock-in, no paywalled features.
- Full source available on GitHub
- Every line auditable by your security team
- Fork, extend, and self-host with no restrictions
- No telemetry, no usage reporting
-**Production Ready** — Built for teams that can't afford surprises.
+**Production Ready.** Built for teams that can't afford surprises.
- 1,000+ passing tests with full regression coverage
- `PipelineValidator` catches configuration errors at startup
- `FailureHandler` with exponential backoff and dead-letter queues
-- Ongoing security hardening: fixes shipped in every release ([CHANGELOG](https://github.com/semantica-agi/semantica/blob/main/CHANGELOG.md))
+- Ongoing security hardening, with fixes shipped in every release ([CHANGELOG](https://github.com/semantica-agi/semantica/blob/main/CHANGELOG.md))
-**Modular by Design** — Import only what you need.
+**Modular by Design.** Import only what you need.
- Use `NERExtractor` without a graph store
- Use `ContextGraph` without vector storage
- Every component independently swappable and testable
-- No framework lock-in: works with any agent stack
+- No framework lock-in, and works with any agent stack