Python SDK Installation
Requirements
Section titled “Requirements”- Python 3.10 or later — the SDK uses
matchstatements and modern typing features. - A running HEBBS server to connect to (see Deployment).
Install with pip
Section titled “Install with pip”pip install hebbsTo pin to a specific version:
pip install hebbs==0.1.0Install with Poetry
Section titled “Install with Poetry”poetry add hebbsInstall with uv
Section titled “Install with uv”uv add hebbsVerify Installation
Section titled “Verify Installation”python -c "import hebbs; print(hebbs.__version__)"You should see the installed version printed, e.g. 0.1.0.
Optional Dependencies
Section titled “Optional Dependencies”The base package includes everything needed to connect to a HEBBS server. Optional extras are available for specific use cases:
| Extra | Install Command | Purpose |
|---|---|---|
dev | pip install hebbs[dev] | Development tools (pytest, mypy, ruff) |
Supported Platforms
Section titled “Supported Platforms”The hebbs package is a pure-Python wrapper over gRPC and supports all platforms where grpcio is available:
- Linux (x86_64, aarch64)
- macOS (x86_64, Apple Silicon)
- Windows (x86_64)
Next Steps
Section titled “Next Steps”- Quick Start — connect to HEBBS and run your first operations
- Client Reference — full API documentation