> ## 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.