> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shannon.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutorials

> Learn Shannon through hands-on examples and practical guides

## Welcome to Shannon Tutorials

Learn how to build powerful AI agent applications with Shannon through practical, hands-on tutorials. Each tutorial includes complete working code, step-by-step instructions, and best practices.

<Note>
  This section is actively being developed. New tutorials are added regularly based on community feedback and common use cases.
</Note>

## Available Tutorials

### Building Agents

<CardGroup cols={2}>
  <Card title="Deep Research Agent" icon="magnifying-glass" href="/en/tutorials/research-assistant">
    Build a multi-source research agent with memory, citations, verification, and adaptive patterns

    <br />

    **Status**: ✅ Available
  </Card>
</CardGroup>

### Extension & Integration

<CardGroup cols={2}>
  <Card title="Adding Custom Tools" icon="wrench" href="/en/tutorials/custom-tools">
    Complete guide to extending Shannon with MCP, OpenAPI, and built-in Python tools

    <br />

    **Status**: ✅ Available
  </Card>

  <Card title="Vendor Adapters" icon="plug" href="/en/tutorials/vendor-adapters">
    Build vendor-specific integrations with the adapter pattern for domain-specific APIs

    <br />

    **Status**: ✅ Available
  </Card>

  <Card title="Workflow Templates" icon="file-code" href="/en/tutorials/templates">
    Create deterministic, zero-token workflows using YAML templates with DAG support

    <br />

    **Status**: ✅ Available
  </Card>

  <Card title="Extending Shannon" icon="puzzle-piece" href="/en/tutorials/extending-shannon">
    Explore all extension methods: templates, tools, vendor adapters, and custom decomposition

    <br />

    **Status**: ✅ Available
  </Card>
</CardGroup>

## What You'll Learn

Across these tutorials, you'll learn:

* **Agent Design**: How to structure agent tasks and workflows
* **Tool Integration**: Connecting agents to external APIs and services
* **Session Management**: Building stateful, multi-turn conversations
* **Error Handling**: Robust patterns for production agents
* **Cost Optimization**: Budget management and token efficiency
* **Monitoring**: Tracking agent performance and behavior

## Prerequisites

Before starting these tutorials, make sure you have:

1. **Shannon Installed**: Follow the [Installation Guide](/en/quickstart/installation)
2. **Basic Python Knowledge**: Familiarity with Python 3.9+
3. **API Keys**: At least one LLM provider API key (OpenAI, Anthropic, etc.)
4. **Docker**: For running Shannon services locally

## Tutorial Structure

Each tutorial follows a consistent structure:

1. **Overview**: What you'll build and why
2. **Prerequisites**: Required setup and dependencies
3. **Step-by-Step**: Detailed implementation guide
4. **Code Examples**: Complete working code you can run
5. **Testing**: How to verify your implementation
6. **Next Steps**: Ideas for extending the tutorial

## Contributing Tutorials

Have an idea for a tutorial? We welcome community contributions!

1. Check existing [GitHub issues](https://github.com/Kocoro-lab/Shannon/issues?q=label%3Atutorial)
2. Propose new tutorials in [GitHub Discussions](https://github.com/Kocoro-lab/Shannon/discussions)
3. Submit tutorial PRs following our [contribution guidelines](https://github.com/Kocoro-lab/Shannon/blob/main/CONTRIBUTING.md)

## Get Help

If you get stuck on any tutorial:

* Search [GitHub Discussions](https://github.com/Kocoro-lab/Shannon/discussions) for similar questions
* File an issue if you find bugs or unclear instructions

## What's Next?

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    New to Shannon? Start here
  </Card>

  <Card title="Core Concepts" icon="book" href="/en/quickstart/concepts/agents">
    Understand Shannon's fundamentals
  </Card>

  <Card title="API Reference" icon="code" href="/en/api/overview">
    Explore the REST API
  </Card>

  <Card title="Python SDK" icon="python" href="/en/sdk/python/quickstart">
    Use the SDK in your applications
  </Card>
</CardGroup>