# Tutorials

Step-by-step guides for common use cases with Mamba Agents.

## Available Tutorials

<div class="grid cards" markdown>

-   :material-code-braces: **Building a Code Assistant**

    ---

    Build a complete coding assistant that can read, analyze, and modify code.

    **Topics:** Tools, multi-turn conversations, file operations

    [:octicons-arrow-right-24: Start Tutorial](code-assistant.md)

-   :material-tools: **Creating Custom Tools**

    ---

    Learn to create, test, and register custom tools for your agents.

    **Topics:** Tool decorators, type hints, error handling

    [:octicons-arrow-right-24: Start Tutorial](custom-tools.md)

-   :material-state-machine: **ReAct Workflow Deep Dive**

    ---

    Master the ReAct workflow pattern for complex multi-step tasks.

    **Topics:** Workflows, reasoning traces, hooks

    [:octicons-arrow-right-24: Start Tutorial](react-workflow.md)

-   :material-server: **Local LLM Setup**

    ---

    Configure and use local models with Ollama, vLLM, or LM Studio.

    **Topics:** Model backends, configuration, troubleshooting

    [:octicons-arrow-right-24: Start Tutorial](local-llm-setup.md)

</div>

## Prerequisites

Before starting these tutorials, make sure you have:

1. **Python 3.12+** installed
2. **Mamba Agents** installed (`uv add mamba-agents`)
3. **API access** to a model provider (or local model server)

## Tutorial Structure

Each tutorial follows a consistent structure:

1. **Overview** - What you'll build and learn
2. **Prerequisites** - What you need before starting
3. **Step-by-step guide** - Detailed instructions with code
4. **Complete example** - Full working code
5. **Next steps** - Where to go from here

## Quick Links

| Tutorial | Difficulty | Time |
|----------|------------|------|
| [Code Assistant](code-assistant.md) | Intermediate | 20 min |
| [Custom Tools](custom-tools.md) | Beginner | 15 min |
| [ReAct Workflow](react-workflow.md) | Advanced | 30 min |
| [Local LLM Setup](local-llm-setup.md) | Beginner | 15 min |
