What is ThemisDB?
ThemisDB is an enterprise-grade, multi-model database engine that combines relational, graph, vector, document, geospatial, and time-series storage in a single system โ with native AI/LLM integration built in. It is designed for workloads that require strong transactional guarantees, distributed operation, and advanced analytical capabilities alongside modern machine-learning workflows.
ThemisDB has comprehensive documentation for all 50 modules with production-ready standards:
Key capabilities at a glance:
| Capability | Details |
|---|
| Multi-model storage | Relational ยท Graph ยท Vector (HNSW/FAISS) ยท Document ยท Geospatial ยท Time-series |
| ACID transactions | MVCC, SSI, 2PC, SAGA orchestration, HLC-based global ordering |
| Distributed | Raft consensus, mTLS replication, consistent-hash sharding, auto-failover |
| AI/LLM native | Embedded LLM inference (llama.cpp, ONNX), RAG pipeline, prompt engineering, LoRA fine-tuning |
| Full-text search | BM25 + vector hybrid search (RRF), faceted, conversational, multi-modal |
| Observability | Prometheus metrics, OpenTelemetry tracing, PagerDuty/Slack alerting |
| Security | AES-256-GCM field encryption, RLS, Zero-Trust policy, eIDAS timestamping, HSM/Vault |
| Editions | MINIMAL ยท COMMUNITY ยท ENTERPRISE ยท MILITARY ยท HYPERSCALER |
Quick Start
Docker (fastest)
docker pull
docker run
Connect via the wire protocol on port 8766 or the REST/HTTP API on port 8765.
Build from source
git clone https://github.com/makr-code/ThemisDB.git
cd ThemisDB
# Install dependencies and configure build environment
./scripts/setup-pre-commit.sh # Linux/macOS
# pwsh ./scripts/setup-third-party.ps1 # all platforms (vcpkg, llama.cpp, ffmpeg)
cmake --preset linux-release # Linux x64
cmake --build --preset linux-release
# Windows (run from VS Developer Command Prompt):
# cmake --preset windows-release && cmake --build --preset windows-release
See QUICKSTART.md for a step-by-step guide, and SETUP.md for a full development-environment walkthrough.
Editions
ThemisDB is available in five editions, selected at CMake build time:
| Edition | Use case | Branch | Build flag |
|---|
| MINIMAL | Embedded / resource-constrained | main | -DTHEMIS_EDITION=MINIMAL |
| COMMUNITY | Open-source, self-hosted | main | -DTHEMIS_EDITION=COMMUNITY |
| ENTERPRISE | Commercial, SLA-backed | enterprise | -DTHEMIS_EDITION=ENTERPRISE |
| MILITARY | Hardened / air-gapped | enterprise | -DTHEMIS_EDITION=MILITARY |
| HYPERSCALER | Cloud/OEM, Kubernetes operator | hyperscaler | -DTHEMIS_EDITION=HYPERSCALER |
Feature sets are nested: MINIMAL โ COMMUNITY โ ENTERPRISE โ HYPERSCALER.
See RELEASE_STRATEGY.md for the full feature comparison and edition matrix.
Architecture
ThemisDB is organised into 55 source modules under src/, grouped into four logical layers:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ API Layer REST ยท GraphQL ยท gRPC ยท Wire V2 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Query Layer AQL ยท Optimizer ยท Planner ยท Cache โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Storage Layer RocksDB ยท MVCC ยท WAL ยท Sharding โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Distributed Raft ยท Replication ยท Failover ยท CDC โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Full architecture reference: ARCHITECTURE.md
โ Module list and status: roadmap.md
Documentation
Versioning
ThemisDB follows Semantic Versioning 2.0.0. The current version is stored in the VERSION file and in CHANGELOG.md. Pre-release identifiers use the form -rcN (release candidate) or -alphaN / -betaN.
See VERSIONING.md for the full versioning policy.
Contributing
Contributions are welcome! Please read CONTRIBUTING.md before submitting a pull request. All participants are expected to follow our Code of Conduct.
Good first issues are tagged good first issue in the issue tracker.
Security
To report a security vulnerability, do not open a public issue. Follow the responsible disclosure process in SECURITY.md or use GitHub Security Advisories.
License
ThemisDB is released under the MIT License.
Module Documentation
> Per-module documentation lives in src//README.md and include//. This section is a navigation index.