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

# Agent templates

> Clone a runnable agent template to get started faster. Nine examples covering common LangGraph and ADK patterns.

If you'd rather start from working code than write an agent from scratch, the [idun-agent-template](https://github.com/Idun-Group/idun-agent-template) repository has nine runnable examples you can clone and adapt.

Each template is a self-contained folder with its own config, dependencies, and agent code. Pick the one closest to what you're building and modify from there.

## LangGraph templates

| Template | What it demonstrates |
| - | - |
| `langgraph-simple` | Basic two-step planning pattern. Good starting point |
| `langgraph-tool-node` | Tool calling with LangGraph's built-in ToolNode (recommended pattern) |
| `langgraph-tool` | Manual tool invocation for cases where you need full control |
| `langgraph-tool-local` | Mixing local tools with MCP tools from the platform |
| `langgraph-structured` | Separate input/output schemas with typed state |
| `langgraph-editorial-loop` | Multi-step researcher/writer/reviewer workflow with conditional routing |
| `langgraph-copy-paste` | Minimal file operations example |

## ADK templates

| Template | What it demonstrates |
| - | - |
| `adk-tool` | Basic LlmAgent with tool integration |
| `adk-structured` | Structured input/output with typed schemas |

## Get started

<Steps>
  <Step title="Clone the template repo">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    git clone https://github.com/Idun-Group/idun-agent-template.git
    cd idun-agent-template
    ```
  </Step>

  <Step title="Pick a template">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    cd langgraph-tool-node
    ```
  </Step>

  <Step title="Install dependencies and configure">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    pip install -r requirements.txt
    cp .env.example .env
    # Edit .env with your API keys
    ```
  </Step>

  <Step title="Run it">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    idun init
    ```

    Runs migrations, seeds the DB from the template's `config.yaml`, opens the browser at `http://localhost:<port>/` (default 8000; override with `--port` or `IDUN_PORT`), and serves the standalone app. `idun init` is idempotent, so you can re-run it on the same folder. For routine restarts that skip migration/seed work, prefer `idun serve`.
  </Step>
</Steps>

## Which template should you pick?

* **First time with Idun?** Start with `langgraph-simple`. It's the shortest path to a running agent.
* **Need tool calling?** Use `langgraph-tool-node`. It follows the recommended LangGraph pattern.
* **Want MCP tools from the platform AND local tools?** Use `langgraph-tool-local`.
* **Building with Google ADK?** Start with `adk-tool`.
* **Need typed input/output schemas?** Look at `langgraph-structured` or `adk-structured`.
* **Building a multi-step workflow?** The `langgraph-editorial-loop` shows a researcher/writer/reviewer pattern with conditional routing.

## Templates vs. the quickstart

The [quickstart](/quickstart) walks you through the minimal steps to run an agent (a few lines of code). Templates give you more structure: proper project layout, config files, environment management, and patterns you'll need as your agent grows. Both paths end at the same place: an agent running under the standalone with chat UI, admin, and traces.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.