Skip to content

Installation

Murmur supports Python 3.11, 3.12, and 3.13.

Core install

pip install murmur-runtime

This pulls in pydantic, pydantic-ai, faststream, structlog, and pyyaml. It's enough to run AsyncBackend — the default in-process backend — without any broker or external service.

Broker extras

When you're ready to distribute work across machines, add the matching extra:

pip install "murmur-runtime[kafka]"

pip install "murmur-runtime[nats]"

pip install "murmur-runtime[rabbitmq]"

pip install "murmur-runtime[redis]"

pip install "murmur-runtime[all-brokers]"

The extra installs the matching faststream integration. Murmur's AgentRuntime parses the broker URL scheme (kafka://, nats://, amqp://, redis://) and constructs the right broker internally — you never import KafkaBroker etc.

Server extras

The HTTP server (murmur.server.AgentServer and the murmur serve CLI) bring fastapi, uvicorn, and sse-starlette:

pip install "murmur-runtime[server]"

Persistent run-store extras

The default InMemoryRunStore loses in-flight runs on restart. For production, pick one:

pip install "murmur-runtime[sqlite]"          # single-host, file-backed
pip install "murmur-runtime[redis-runstore]"  # cluster-wide
pip install "murmur-runtime[rocksdb]"         # high-throughput single-host

All three implement the same RunStore Protocol and pass the same RunStoreContract test suite.

Development install

git clone https://github.com/droidnoob/murmur-ai && cd murmur-runtime
uv sync --group dev
uv run pytest -m "not integration" -q     # 556 tests, all green

The dev group installs ruff, ty, pytest, hypothesis, pre-commit, and every broker / runstore concrete so the contract suites run end-to-end.