Skip to content

Python SDK Installation

  • Python 3.10 or later — the SDK uses match statements and modern typing features.
  • A running HEBBS server to connect to (see Deployment).
Terminal window
pip install hebbs

To pin to a specific version:

Terminal window
pip install hebbs==0.1.0
Terminal window
poetry add hebbs
Terminal window
uv add hebbs
Terminal window
python -c "import hebbs; print(hebbs.__version__)"

You should see the installed version printed, e.g. 0.1.0.

The base package includes everything needed to connect to a HEBBS server. Optional extras are available for specific use cases:

ExtraInstall CommandPurpose
devpip install hebbs[dev]Development tools (pytest, mypy, ruff)

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)