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 commonDocumentation 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.
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
| Feature | LangGraph | Google ADK |
|---|---|---|
| AG-UI streaming | Yes | Yes |
| Checkpointing / memory | In-memory, SQLite, PostgreSQL | In-memory, Vertex AI, Database |
| CopilotKit support | Yes | No |
| Guardrails | Yes | Yes |
| Observability | Yes | Yes |
| MCP servers | Yes | Yes |
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 servecommand runs any supported framework.
type field in the agent section of your config.yaml:
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.