Skip to content

Getting Started

Welcome to Mamba Agents! This section will help you get up and running quickly.

Prerequisites

  • Python 3.12+ - Mamba Agents requires Python 3.12 or later
  • API Key - An API key for your chosen model provider (OpenAI, Anthropic, etc.), or a local model server

What's in this section

  • Installation

    Install Mamba Agents using uv or pip, including optional dependencies.

    Installation

  • Quick Start

    Create and run your first agent in under 5 minutes.

    Quick Start

  • Configuration

    Learn how to configure the agent using environment variables, .env files, and TOML.

    Configuration

Overview

Mamba Agents is a thin wrapper around pydantic-ai that adds enterprise-grade infrastructure:

Feature Description
Context Management Automatic message tracking with 5 compaction strategies
Token Tracking Built-in usage and cost estimation
Workflows Orchestration patterns like ReAct for multi-step tasks
MCP Integration Connect to Model Context Protocol servers
Observability Structured logging, tracing, and OpenTelemetry
Error Handling Retry logic and circuit breaker patterns

The simplest way to start is:

from mamba_agents import Agent

agent = Agent("gpt-4o")
result = agent.run_sync("Hello!")
print(result.output)

Continue to the Installation guide to get started.