Idun Agent Templates

March 22, 2026 ยท View on GitHub

This repository contains simple agent templates and examples you can run with the Idun Agent Platform.

It is a starter repo for teams who want to build agents with:

  • ADK
  • LangGraph
  • (and extend to LangChain-based patterns)

Goal of this repository

Use this repo as a practical starting point to:

  • bootstrap new agent projects quickly
  • test local agent behavior
  • connect agents to Idun for deployment and governance

The templates in this repo are designed to run with Idun.

With Idun Platform, your agent can be exposed as a production-ready service with features like API standardization, observability, memory, and governance controls.

Repository structure

  • adk-tool/: ADK example agent with tools
  • adk-structured/: ADK example agent with structured input and output
  • langgraph-simple/: minimal LangGraph example agent
  • langgraph-tool/: LangGraph agent using Idun tools (manual tool-call workaround)
  • langgraph-tool-node/: LangGraph agent using Idun tools with ToolNode
  • langgraph-tool-local/: LangGraph agent combining local math tools + Idun tools
  • langgraph-structured/: structured input/output LangGraph internal system agent
  • langgraph-editorial-loop/: LangGraph multi-step researcher/writer/reviewer loop agent
  • langgraph-copy-paste/: simple LangGraph file copy example using local folders

Each example includes:

  • agent code in agent/
  • a requirements.txt
  • a my_agent.yaml configuration file
  • an .env.example for environment setup

Quick start

  1. Pick a template folder (for example adk-tool/, adk-structured/, langgraph-simple/, langgraph-tool/, langgraph-tool-local/, langgraph-structured/, langgraph-editorial-loop/, or langgraph-copy-paste/).

  2. Install dependencies:

    pip install -r requirements.txt

  3. Create your env file from .env.example and set your variables.

  4. Run your agent locally (for ADK projects, for example):

    adk web --port 8010

Connect to Idun Platform

To connect any template to the Idun Manager for centralized management, guardrails, observability, memory, and MCP tool governance:

  1. Create the agent in the Manager UI.

  2. Copy the API key from the Agent Detail > API Integration tab.

  3. Set environment variables:

    export IDUN_MANAGER_HOST=http://localhost:8000
export IDUN_AGENT_API_KEY=<your-api-key>

  4. Run in managed mode:

    idun agent serve --source manager

The agent fetches its config from the platform. Any guardrails, observability, memory, or MCP tools you configure in the UI are automatically applied.

Documentation

Need help with a custom agent setup? Book a call or email contact@idun-group.com.