Already installed? Jump straight to Quickstart. Need setup help first? See Installation.

What You Can Build

GraphRAG Systems

Ground LLM responses in traceable, structured knowledge. Every claim links back to a source node.

Accountable AI Agents

Agents with structured decision history, causal chains, and precedent search. Every choice is recorded and auditable.

Production Knowledge Graphs

Build, validate, and maintain enterprise-grade semantic knowledge bases from multi-source data.

Compliance-Ready AI

W3C PROV-O provenance on every fact. HIPAA, SOX, GDPR, FDA 21 CFR Part 11 infrastructure built in.

Setup in 3 Steps

1

Install Semantica

pip install semantica
Verify installation:
import semantica
print(semantica.__version__)  # 0.5.0
2

Choose your path

Pick the track that matches what you’re building: each starts with a focused 5-minute example.
TrackYou want to…Start with
Knowledge GraphTurn documents into structured, queryable graphsQuickstart → Step 1
Agent ContextGive your AI agent persistent memory and decision trackingContext reference
GraphRAGGround LLM answers in structured knowledgeConcepts → GraphRAG
MCP IntegrationUse Semantica from Claude Desktop or VS CodeMCP Server
3

Run the pipeline

The full 6-step pipeline: ingest, parse, extract, build, visualize, export: is in the Quickstart. Takes under 5 minutes with pattern-based extraction (no API key required).
An LLM API key is optional for the quickstart. Pattern-based extraction works out of the box: upgrade to LLM extraction for higher accuracy when you’re ready.

Choose Your Path

Build a structured knowledge graph from any document or data source.
from semantica.ingest import FileIngestor
from semantica.parse import DocumentParser
from semantica.semantic_extract import NERExtractor, RelationExtractor
from semantica.kg import GraphBuilder

# 1. Ingest
sources = FileIngestor().ingest("data/report.pdf")

# 2. Parse
parsed = DocumentParser().parse(sources[0])

# 3. Extract
ner           = NERExtractor(method="pattern")  # no API key needed
entities      = ner.extract(parsed)
relationships = RelationExtractor().extract(parsed, entities=entities)

# 4. Build
graph = GraphBuilder(merge_entities=True).build(
    entities=entities, relationships=relationships
)
print(f"{len(graph['nodes'])} nodes, {len(graph['relationships'])} edges")
Next: Full pipeline walkthrough →

Core Architecture

Semantica uses a modular, layered architecture: import only what you need.

Input Layer

Load and prepare data from any source. Modules: ingest, parse, split, normalize

Semantic Layer

Extract meaning from raw text. Modules: semantic_extract, kg, ontology, reasoning

Storage Layer

Persist knowledge for retrieval. Modules: embeddings, vector_store, graph_store, triplet_store

Quality Layer

Validate and deduplicate. Modules: deduplication, conflicts

Context Layer

Track decisions and lineage. Modules: context, provenance, change_management

Output Layer

Deliver results downstream. Modules: export, visualization, pipeline, explorer

”Which module do I need?” Quick Reference

I want to…ModuleKey class
Load a PDF / web page / databaseingestFileIngestor, WebIngestor
Extract text and tables from a PDFparseDocumentParser, DoclingParser
Find entities in textsemantic_extractNERExtractor
Build a knowledge graphkgGraphBuilder
Store and search vectorsvector_storeVectorStore
Give my agent persistent memorycontextAgentContext
Record AI decisions with audit trailcontextAgentContext.record_decision()
Query my graph with natural languagereasoningGraphReasoner
Export to RDF / Neo4j / ParquetexportRDFExporter, LPGExporter
Visualize a knowledge graphvisualizationKGVisualizer
Run a reproducible pipelinepipelinePipelineBuilder
Use Semantica from Claude Desktopmcp_serversemantica-mcp

Next Steps

Core Concepts

Knowledge graphs, ontologies, and reasoning explained in depth.

Quickstart Tutorial

Full 6-step pipeline walkthrough with working code.

Module Reference

Every module, class, and common chain explained.

API Reference

Complete module documentation for every class and method.

Help

Discord

Ask questions, share projects, get community support.

GitHub Issues

Report bugs or request features.

FAQ

Common questions answered.