|
| 1 | +Metadata-Version: 2.4 |
| 2 | +Name: smartcrdt |
| 3 | +Version: 1.0.0 |
| 4 | +Summary: Pure Python CRDT library for distributed agent state |
| 5 | +License: MIT |
| 6 | +Keywords: crdt,distributed,eventual-consistency,agent,state |
| 7 | +Classifier: Development Status :: 4 - Beta |
| 8 | +Classifier: Intended Audience :: Developers |
| 9 | +Classifier: License :: OSI Approved :: MIT License |
| 10 | +Classifier: Programming Language :: Python :: 3 |
| 11 | +Classifier: Programming Language :: Python :: 3.9 |
| 12 | +Classifier: Programming Language :: Python :: 3.10 |
| 13 | +Classifier: Programming Language :: Python :: 3.11 |
| 14 | +Classifier: Programming Language :: Python :: 3.12 |
| 15 | +Classifier: Topic :: Software Development :: Libraries |
| 16 | +Requires-Python: >=3.9 |
| 17 | +Description-Content-Type: text/markdown |
| 18 | +License-File: LICENSE |
| 19 | +Provides-Extra: dev |
| 20 | +Requires-Dist: pytest>=7.0; extra == "dev" |
| 21 | +Dynamic: license-file |
| 22 | + |
| 23 | +# SmartCRDT |
| 24 | + |
| 25 | +**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. |
| 26 | + |
| 27 | +## What This Gives You |
| 28 | + |
| 29 | +- **81 packages** — modular CRDT types, vector stores, agents, and monitoring |
| 30 | +- **ChromaDB integration** — vector embeddings for semantic search |
| 31 | +- **Python bridge** — use CRDTs from Python alongside TypeScript |
| 32 | +- **Docker Compose stack** — PostgreSQL, Redis, ChromaDB, Ollama in one command |
| 33 | +- **Real-time observability** — live dashboards for CRDT merge tracking |
| 34 | +- **Rust native modules** — performance-critical operations compiled to native code |
| 35 | + |
| 36 | +## Quick Start |
| 37 | + |
| 38 | +### Docker (fastest) |
| 39 | + |
| 40 | +```bash |
| 41 | +git clone https://github.com/SuperInstance/SmartCRDT.git |
| 42 | +cd SmartCRDT |
| 43 | +docker-compose up -d |
| 44 | +``` |
| 45 | + |
| 46 | +### From source |
| 47 | + |
| 48 | +```bash |
| 49 | +pnpm install |
| 50 | +pnpm build |
| 51 | +pnpm test |
| 52 | +``` |
| 53 | + |
| 54 | +## CRDT Types |
| 55 | + |
| 56 | +| Type | Description | |
| 57 | +|------|-------------| |
| 58 | +| `G-Counter` | Grow-only counter | |
| 59 | +| `PN-Counter` | Increment/decrement counter | |
| 60 | +| `G-Set` | Grow-only set | |
| 61 | +| `OR-Set` | Observed-remove set | |
| 62 | +| `LWW-Register` | Last-writer-wins register | |
| 63 | +| `LWW-Map` | Last-writer-wins map | |
| 64 | +| `RGA` | Replicated growable array (sequence) | |
| 65 | + |
| 66 | +## Architecture |
| 67 | + |
| 68 | +``` |
| 69 | +packages/ |
| 70 | +├── crdt-core/ # Core CRDT types |
| 71 | +├── crdt-merge/ # Merge strategies |
| 72 | +├── vector-store/ # ChromaDB integration |
| 73 | +├── observability/ # Real-time monitoring |
| 74 | +├── python-bridge/ # Python bindings |
| 75 | +└── native/ # Rust performance modules |
| 76 | +``` |
| 77 | + |
| 78 | +## Testing |
| 79 | + |
| 80 | +```bash |
| 81 | +pnpm test # All tests |
| 82 | +pnpm test:coverage # With coverage |
| 83 | +pnpm test:unit # Unit tests only |
| 84 | +``` |
| 85 | + |
| 86 | +## How It Fits |
| 87 | + |
| 88 | +The distributed state backbone of the SuperInstance ecosystem. All fleet agents use SmartCRDT for state synchronization, conflict resolution, and offline-first operation. |
| 89 | + |
| 90 | +## License |
| 91 | + |
| 92 | +MIT |
0 commit comments