High-performance multi-model database with native AI/LLM integration
📚 Documentation · 🚀 Quick Start · ❓ FAQ · Release Notes · Roadmap
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.
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 |
docker pull ghcr.io/makr-code/themisdb:latest
docker run -p 8765:8765 -p 8766:8766 ghcr.io/makr-code/themisdb:latestConnect via the wire protocol on port 8766 or the REST/HTTP API on port 8765.
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 community-release
cmake --build --preset community-releaseSee QUICKSTART.md for a step-by-step guide, and SETUP.md for a full development-environment walkthrough.
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.
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
| Document | Description |
|---|---|
| QUICKSTART.md | Get running in minutes |
| SETUP.md | Full development environment setup |
| ARCHITECTURE.md | System design and module overview |
| VERSIONING.md | Versioning policy and release cadence |
| RELEASE_STRATEGY.md | Branch model, edition matrix, CI/CD pipeline |
| CHANGELOG.md | Release notes (Keep a Changelog format) |
| PERFORMANCE_EXPECTATIONS.md | Benchmarks and performance targets |
| SOP.md | Standard operating procedures (release, hotfix, incident) |
| GOVERNANCE.md | Project governance: roles, decision-making, contribution policy |
| MAINTAINERS.md | Maintainer roster and module ownership |
| SECURITY.md | Security policy and vulnerability reporting |
| CONTRIBUTING.md | How to contribute |
| CODE_OF_CONDUCT.md | Community guidelines |
| SUPPORT.md | Where to get help |
| INDEX.md | Full project structure index |
| docs/ | Extended documentation (API reference, guides, research) |
| compendium/ | In-depth technical compendium |
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.
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.
To report a security vulnerability, do not open a public issue. Follow the responsible disclosure process in SECURITY.md or use GitHub Security Advisories.
ThemisDB is released under the MIT License.
Per-module documentation lives in
src/<module>/README.mdandinclude/<module>/. This section is a navigation index.