Skip to main content

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.

Idun Engine wraps your agent code into a FastAPI service through framework-specific adapters. You write your agent in the framework you prefer, and the engine handles streaming, checkpointing, guardrails, and observability through a unified API. Each adapter implements a common BaseAgent protocol. Your clients talk to the same HTTP API regardless of the underlying framework.

Supported frameworks

LangGraph

Graph-based agents with full AG-UI streaming, checkpointing (in-memory, SQLite, PostgreSQL), and CopilotKit support. Has the most complete feature coverage of the supported frameworks.

Google ADK

Google’s Agent Development Kit for Gemini-powered agents. Supports session and memory services through in-memory, Vertex AI, or database backends.

Deep Agents

LangChain’s framework for agents that plan, write to a virtual filesystem, and spawn subagents. Runs as a regular LangGraph agent in Idun (no separate adapter, no glue code).

Documentation and source code

Haystack support was removed in 0.6.0. Existing Haystack agent configs need to be ported to LangGraph or ADK before upgrading.

Feature comparison

FeatureLangGraphGoogle ADK
AG-UI streamingYesYes
Checkpointing / memoryIn-memory, SQLite, PostgreSQLIn-memory, Vertex AI, Database
CopilotKit supportYesNo
GuardrailsYesYes
ObservabilityYesYes
MCP serversYesYes

How adapters work

Under the hood, the engine loads your agent through the adapter specified in your configuration. This gives you:
  • Unified API: All agents expose the same HTTP endpoints for invoke, streaming, and chat.
  • Shared platform features: Observability, guardrails, MCP tools, and memory work the same way across frameworks.
  • Consistent deployment: The same idun serve command runs any supported framework.
Select the framework by setting the type field in the agent section of your config.yaml:
agent:
  type: LANGGRAPH    # or ADK
  config:
    # framework-specific fields
The engine validates that the config shape matches the selected type at startup. The standalone admin panel at /admin/agent/ exposes the same field with a dropdown when you want to switch frameworks without editing YAML.

Next steps

LangGraph integration guide

Graph-based agents with full AG-UI streaming, checkpointing, and CopilotKit support.

Google ADK integration guide

Google’s Agent Development Kit for Gemini-powered agents with session and memory services.

Custom adapter

Build your own adapter to bring a different agent framework into Idun Engine.

Configuration reference

Full schema for config.yaml including agent, guardrails, MCP, observability, and more.
Last modified on May 22, 2026