Hanzo KV
High-performance key-value store for the Hanzo ecosystem.
In-memory data store used as database, cache, streaming engine, and message broker.
Features
- In-memory key-value store -- sub-millisecond reads and writes
- Redis-compatible protocol -- drop-in replacement for existing Redis clients
- Persistence -- RDB snapshots and AOF (append-only file) for durability
- Replication -- primary-replica with automatic failover via Sentinel
- Lua scripting -- server-side scripting for atomic operations
- Pub/Sub -- publish and subscribe messaging
- Streams -- append-only log data structure for event sourcing
- Cluster mode -- horizontal scaling with automatic sharding
- Modules -- extensible plugin system for custom data structures
- Multi-arch -- linux/amd64 and linux/arm64
Quick Start
Docker
docker run -d --name hanzo-kv -p 6379:6379 ghcr.io/hanzoai/kv
Connect
docker exec -it hanzo-kv kv
127.0.0.1:6379> SET hello world
OK
127.0.0.1:6379> GET hello
"world"
Any Redis-compatible CLI also works out of the box.
Build from Source
make
make test
make install
CLI Tools
| Command | Description |
|---|---|
kv |
Interactive CLI (default) |
kv-server |
Start KV server |
kv-cli |
Command-line client |
kv-sentinel |
High-availability sentinel |
kv-benchmark |
Performance benchmarking |
kv-check-aof |
AOF file integrity check |
kv-check-rdb |
RDB file integrity check |
Configuration
Pass a config file at startup:
kv-server /etc/kv/kv.conf
Or set options via command line:
kv-server --port 6379 --maxmemory 256mb --appendonly yes
Client SDKs
| Language | Package | Install |
|---|---|---|
| Python | hanzo-kv | pip install hanzo-kv |
| Go | hanzo/kv-go | go get github.com/hanzoai/kv-go |
| Node.js | @hanzo/kv | npm install @hanzo/kv |
Any Redis-compatible client library will also work.
Documentation
Full documentation is available at docs.hanzo.ai.
License
BSD-3-Clause
Copyright (c) 2024-2026 Hanzo AI Inc. All rights reserved.