Installation

StreamBlocks requires Python 3.13 or later.

uvpip

uv add streamblocks

pip install streamblocks

Package name vs. import name

The package is installed as streamblocks but imported from the hother namespace:

from hother.streamblocks import Registry, StreamBlockProcessor

Provider extras

The core library has no provider dependencies. Install extras for the providers you use:

uvpip

uv add streamblocks[all-providers]

pip install streamblocks[all-providers]

Extra	Enables
`gemini`	Google Gemini input adapter (`google-genai`)
`openai`	OpenAI input adapter (`openai`)
`anthropic`	Anthropic Claude input adapter (`anthropic`)
`all-providers`	All of the above
`structlog`	structlog logging integration
`loguru`	Loguru logging integration
`examples`	Dependencies for running the bundled examples

To work on StreamBlocks itself or run the examples from a clone:

git clone https://github.com/hotherio/streamblocks.git
cd streamblocks
uv sync --all-groups

To build the documentation you also need the d2 diagram renderer (brew install d2).

Continue with the Quickstart.