SmartCRDT

Self-improving infrastructure for AI applications powered by CRDTs — distributed state management, vector search, real-time observability, and a full Docker-based development stack. TypeScript monorepo with optional Rust native modules.

What This Gives You

• 81 packages — modular CRDT types, vector stores, agents, and monitoring
• ChromaDB integration — vector embeddings for semantic search
• Python bridge — use CRDTs from Python alongside TypeScript
• Docker Compose stack — PostgreSQL, Redis, ChromaDB, Ollama in one command
• Real-time observability — live dashboards for CRDT merge tracking
• Rust native modules — performance-critical operations compiled to native code

Quick Start

Docker (fastest)

git clone https://github.com/SuperInstance/SmartCRDT.git
cd SmartCRDT
docker-compose up -d

From source

pnpm install
pnpm build
pnpm test

CRDT Types

| Type | Description | |------|-------------| | G-Counter | Grow-only counter | | PN-Counter | Increment/decrement counter | | G-Set | Grow-only set | | OR-Set | Observed-remove set | | LWW-Register | Last-writer-wins register | | LWW-Map | Last-writer-wins map | | RGA | Replicated growable array (sequence) |

Architecture

packages/
├── crdt-core/        # Core CRDT types
├── crdt-merge/       # Merge strategies
├── vector-store/     # ChromaDB integration
├── observability/    # Real-time monitoring
├── python-bridge/    # Python bindings
└── native/           # Rust performance modules

Testing

pnpm test              # All tests
pnpm test:coverage     # With coverage
pnpm test:unit         # Unit tests only

How It Fits

The distributed state backbone of the SuperInstance ecosystem. All fleet agents use SmartCRDT for state synchronization, conflict resolution, and offline-first operation.

License

MIT