Skip to content

Installation

Requirements

  • Python 3.12 or later
  • An API key for your model provider (or a local model server)

Basic Installation

uv add mamba-agents

pip install mamba-agents

git clone https://github.com/sequenzia/mamba-agents.git
cd mamba-agents
uv sync

Optional Dependencies

OpenTelemetry Support

For OpenTelemetry integration (tracing and metrics export):

uv add mamba-agents[otel]

pip install mamba-agents[otel]

This installs:

  • opentelemetry-api
  • opentelemetry-sdk

Dependencies

Mamba Agents automatically installs the following core dependencies:

Package Purpose
pydantic-ai Core agent framework
pydantic Data validation
pydantic-settings Configuration management
httpx HTTP client
tenacity Retry logic
tiktoken Token counting
python-dotenv Environment variable loading
pyyaml YAML configuration support

Verifying Installation

After installation, verify everything is working:

from mamba_agents import Agent, AgentSettings

# Check version
import mamba_agents
print(f"Mamba Agents version: {mamba_agents.__version__}")

# Create a simple agent (requires OPENAI_API_KEY)
agent = Agent("gpt-4o")
result = agent.run_sync("Say hello!")
print(result.output)

Development Installation

For contributing to Mamba Agents:

# Clone the repository
git clone https://github.com/sequenzia/mamba-agents.git
cd mamba-agents

# Install with dev dependencies
uv sync --group dev

# Run tests
uv run pytest

# Run linting
uv run ruff check
uv run ruff format --check

Documentation Development

To build and preview the documentation locally:

# Install docs dependencies
uv sync --group docs

# Serve docs locally
uv run mkdocs serve

# Build docs
uv run mkdocs build

Next Steps