v0.5.0 is live: Ontology Hub, Distance Intelligence, SHACL Studio, Parquet & XML ingestion, 12 security fixes. What’s new →
Your AI agent just made a decision. Now someone needs to explain it. 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? 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.

1,000+ Tests

Production-hardened with a full regression suite

25+ Modules

Every capability independently importable

12 LLM Providers

OpenAI, Anthropic, Ollama, Groq, and more

MIT Licensed

Open source, no vendor lock-in, fully forkable

​
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 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 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 lineage from inference back to the original document
  • Impossible 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 basis for improving or correcting future behavior

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
These aren’t edge cases. They’re why enterprise AI pilots stall: and why your compliance team keeps saying not yet.

​
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:

Context Graphs

A structured, queryable graph of everything your agent knows, decides, and reasons about.
  • Persistent across agent runs: 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.
  • 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.
  • 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.
  • 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
  • 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.
  • 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
Works alongside any LLM provider and any agent framework: add it to an existing stack without changing your architecture.
Semantica four-layer architecture: Ingestion → Processing → Intelligence → Application

​
See It In Action

One pip install. A few lines to connect your agent. Everything else becomes traceable. 
pip install semantica

from semantica.context import AgentContext, ContextGraph
from semantica.vector_store import VectorStore
from semantica.llms import OpenAI

context = AgentContext(
    vector_store=VectorStore(backend="faiss", dimension=1536),
    knowledge_graph=ContextGraph(advanced_analytics=True),
    decision_tracking=True,
    llm=OpenAI(model="gpt-4o"),
)

context.store("GPT-4 outperforms GPT-3.5 on reasoning benchmarks by 40%")

decision_id = context.record_decision(
    category="model_selection",
    scenario="Choose LLM for production reasoning pipeline",
    reasoning="GPT-4 benchmark advantage justifies 3x cost increase",
    outcome="selected_gpt4",
    confidence=0.91,
)

precedents = context.find_precedents("model selection reasoning", limit=5)
influence  = context.analyze_decision_influence(decision_id)

Full Quickstart

Step-by-step pipeline walkthrough

Cookbook

40+ real-world Jupyter notebooks

Join Discord

Community chat and support

​
Built for Where Mistakes Have Consequences

Semantica was designed for domains where every decision must be explainable and every fact must be traceable:

Healthcare & Life Sciences

  • Clinical decision support with full audit trails
  • Drug interaction and contraindication graphs
  • Patient safety event tracking and root-cause analysis
  • HIPAA-compliant provenance chains out of the box

Finance & Risk

  • Fraud detection knowledge graphs
  • Risk assessment trails built to survive an audit
  • SOX, GDPR, and MiFID II compliance infrastructure
  • Model decision lineage for regulatory reporting

Legal & Compliance

  • Evidence-backed research with every cited fact provenance-linked
  • Contract analysis with traceable clause extraction
  • Regulatory change tracking across jurisdictions
  • Full reasoning paths ready for court-admissible documentation

Cybersecurity

  • Threat attribution graphs linking actors, TTPs, and indicators
  • Incident response timelines with full event provenance
  • Security audit trails across the complete kill chain
  • MITRE ATT&CK-aligned knowledge graph integration

Government & Defense

  • Policy decision trails from brief to outcome
  • Classified information handling with provenance chains
  • Chain-of-custody scrutiny for intelligence reporting
  • Air-gapped deployment with local LLM support

Critical Infrastructure

  • Power grid state tracking with temporal intelligence
  • Transportation safety event graphs
  • Emergency response coordination with decision audit trails
  • Consequence modeling for high-stakes operational decisions

​
Start Here

1

Install Semantica

pip install semantica
See Installation for optional extras ([all], [neo4j], [pinecone]) and environment setup.
2

Run the Quickstart

Build a complete knowledge graph pipeline in 5 minutes:
  • Ingest documents from any source
  • Extract entities and relationships
  • Build and query the graph
  • Record and trace a decision
3

Learn the mental model

Core Concepts covers:
  • 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
4

Go deep on any module

Every module has a dedicated reference page with:
  • Full class and method documentation
  • Parameter tables with types and defaults
  • Runnable code examples for each feature

Installation

Get Semantica installed in under a minute

Quickstart

Build a complete knowledge graph pipeline in 5 minutes

Core Concepts

The mental model behind the API

API Reference

Exact module, class, and method details

Cookbook

Domain notebooks for real-world use cases

​
What’s New

v0.5.0: Ontology Hub & Distance Intelligence

Released May 11, 2026
AreaHighlights
Ontology HubVisual editor, SHACL Studio, alignment authoring, health dashboard, version control: full ontology lifecycle in the browser
Distance IntelligenceSemantic neighborhoods, N×N distance matrices, ego-mode visualization, distance band classification, embedding cache optimization
Parquet IngestionParquetIngestor with PyArrow: single file, partitioned directories, Hive-style discovery, selective column reading
XML IngestionXMLIngestor with XXE-safe lxml backend, XSD/DTD validation, namespace handling, directory scanning
Graph ExplorerLanding page redesign, bidirectional path finding, indexed search (0.004ms on 118k nodes)
Security12 vulnerability fixes: eval injection, pickle deserialization, SQL injection, XXE, SSRF, ReDoS, path traversal
Bug FixesNER LLM silent fallback on enterprise gateways, ConflictDetector duplicate definition, Windows [all] install, cp1252 crash
pip install semantica==0.5.0
AreaHighlights
Temporal Intelligence6-PR system: temporal data model, point-in-time queries, Allen interval algebra (all 13 relations), OWL-Time export
Knowledge Explorer APIFull FastAPI backend: 99 tests, 12 export formats, WebSocket progress, thread-safe sessions, audit trail
Ontology FoundationsSHACL generation/validation, SKOS vocabulary, ontology alignment API, diff & migration tooling
Datalog ReasoningPure-Python bottom-up semi-naive fixpoint, recursive Horn clause rules, guaranteed termination
Agno Integration5 components: graph-backed memory, multi-hop GraphRAG, decision toolkit, KG toolkit, shared team context; 110 tests

​
Full Capabilities

​
Context Graphs

  • Structured, persistent graph of entities, relationships, and decisions
  • Temporal model with valid_from / valid_until on every node and edge
  • Point-in-time queries across historical graph states
  • Distance Intelligence: semantic neighborhoods and N×N distance matrices

​
Decision Tracking

  • record_decision() with full lifecycle management and causal chains
  • Hybrid similarity search over past decisions for consistency enforcement
  • analyze_decision_impact() and analyze_decision_influence() for consequence modeling
  • Ego-mode exploration for targeted neighborhood investigation

​
Entity & Relation Extraction

  • Named entity recognition: pattern, ML, or LLM methods
  • Typed triplet extraction via LLM or rule-based pipelines
  • Event extraction with temporal and causal linking

​
Ontology & Schema

  • Ontology Hub: visual editor, SHACL Studio, alignments, health dashboard
  • Deduplication v2: blocking_v2, hybrid_v2, semantic_v2: up to 7x faster
  • Datalog reasoning: recursive Horn clause rules with fixpoint semantics
  • SPARQL reasoning: query-based inference over RDF graphs

​
Lineage Tracking

  • W3C PROV-O lineage across all modules: every fact has a source
  • recorded_at stamping with full OWL-Time export
  • Change management with SHA-256 checksums and version control
  • Full audit trails from ingestion event to final inference

​
Compliance Infrastructure

  • HIPAA: patient data handling with audit-ready provenance chains
  • SOX / MiFID II: financial decision records with full traceability
  • GDPR: data lineage for subject access and right-to-erasure workflows
  • FDA 21 CFR Part 11: electronic records and signature compliance

​
Ingestion Formats

  • Documents: PDF, DOCX, HTML, PPTX, Docling layout analysis
  • Structured data: JSON, CSV, Excel, Parquet, XML
  • Sources: web crawl, SQL, Snowflake, feeds, email, code repositories, MCP

​
Vector Stores

  • FAISS, Pinecone, Weaviate, Qdrant, Milvus, PgVector, in-memory

​
Graph Stores

  • Neo4j, FalkorDB, Apache AGE, Amazon Neptune

​
Export Formats

  • RDF: Turtle, JSON-LD, N-Triples, RDF/XML
  • Tabular: Parquet, CSV, Arrow
  • Graph: GraphML, GEXF, DOT, ArangoDB AQL
  • Ontology: OWL, SKOS, SHACL

​
Module Reference

ModuleWhat it provides
semantica.contextContext graphs, agent memory, decision tracking, causal analysis, precedent search
semantica.kgKG construction, graph algorithms, temporal model, Allen interval algebra
semantica.semantic_extractNER, relation extraction, event extraction, triplet generation
semantica.reasoningForward chaining, Rete, deductive, abductive, SPARQL, Datalog
semantica.ontologySHACL, SKOS, alignments, diff/migration, auto-generation, OWL/RDF
semantica.explorerFastAPI Knowledge Explorer, Ontology Hub, Distance Intelligence, SHACL Studio
semantica.mcp_serverMCP stdio server: 12 tools for Claude Desktop, VS Code, Cursor, Windsurf, Cline
semantica.vector_storeFAISS, Pinecone, Weaviate, Qdrant, Milvus, PgVector
semantica.graph_storeNeo4j, FalkorDB, Apache AGE, Amazon Neptune
semantica.triplet_storeIn-memory and persistent RDF triple store with SPARQL
semantica.ingestFiles, web, feeds, databases, Snowflake, Parquet, XML, MCP
semantica.parseDocument parsing: PDF, DOCX, HTML, PPTX, Docling layout analysis
semantica.splitText chunking: sentence, paragraph, token, semantic boundary strategies
semantica.normalizeText normalization, entity canonicalization, whitespace and encoding cleanup
semantica.embeddingsSentence-Transformers, FastEmbed, OpenAI, BGE, Ollama local embeddings
semantica.pipelinePipeline DSL, parallel workers, retry policies, failure handling
semantica.exportRDF, Parquet, ArangoDB AQL, CSV, OWL, Arrow, GraphML, GEXF, DOT
semantica.visualizationProgrammatic graph rendering: force, hierarchical, circular, spring layouts
semantica.deduplicationEntity deduplication v1/v2, similarity scoring, blocking, merging
semantica.conflictsConflict detection and resolution across overlapping knowledge sources
semantica.provenanceW3C PROV-O lineage tracking, source attribution, audit trails
semantica.change_managementVersion control with SHA-256 checksums, diff, rollback
semantica.llmsGroq, OpenAI, Anthropic, Gemini, Ollama, DeepSeek, Novita AI, LiteLLM, HuggingFace
semantica.seedFoundation graph seeding from CSV, JSON, SQL, API, and RDF sources
semantica.evalsEvaluation harness: KG quality, extraction F1, pipeline benchmarking, regression tracking
semantica.coreOrchestration, ConfigManager, LifecycleManager, PluginRegistry, MethodRegistry
semantica.utilsLogging, validation, progress tracking, hash utilities, nested dict helpers

​
Why Semantica?

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.
  • 1,000+ passing tests with full regression coverage
  • PipelineValidator catches configuration errors at startup
  • FailureHandler with exponential backoff and dead-letter queues
  • 12 security vulnerabilities fixed in v0.5.0

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