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

1. Clone the template repo

   git clone https://github.com/Idun-Group/idun-agent-template.git
   cd idun-agent-template
   
2. Pick a template

   cd langgraph-tool-node
   
3. Install dependencies and configure

   pip install -r requirements.txt
   cp .env.example .env
   # Edit .env with your API keys
   
4. Run it

   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.

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