Semantica is built around a four-layer modular architecture. Import only what you need: the framework never forces a full stack. Every component is independently swappable, and every layer communicates through clean interfaces with no hidden coupling.

Four-Layer Architecture

Semantica four-layer architecture
Loads data from any source into the pipeline as a unified SourceDocument.

Data Flow

Every pipeline follows the same linear path from raw source to delivered output: Semantica 8-step pipeline: Ingest → Parse → Normalize → Extract → Build KG → QA → Store → Deliver

Module Map

Extension Points

Every layer exposes a registry-based extension point. Register custom implementations and they participate in the full pipeline with zero changes to core code.

Design Decisions

Every component works standalone. NERExtractor runs without a graph store. VectorStore runs without decision tracking. The framework never forces a full stack instantiation; you pay only for what you import.
Custom ingestors, extractors, validators, and exporters follow the same base class pattern. Register them via PluginRegistry and they participate in the full pipeline (provenance tracking, retry policies, and parallel execution included) with no changes to core code.
Lineage tracking is built into graph construction at the lowest level. Every node and edge carries a source_id pointing back to the originating document, extraction method, and timestamp. There is no opt-in required; provenance is always on.
Centralized ConfigManager with environment variable overrides. No magic defaults; all behavior is explicit and overridable. Suitable for multi-environment deployments where dev, staging, and production need different backends.

Performance Characteristics

  • Modules: full module documentation with code examples.
  • Learning More: configuration reference, performance guide, and troubleshooting.
  • Pipeline Reference: pipeline orchestration, workers, and retry policies.
  • Core Reference: framework lifecycle, plugin registry, and configuration.