What agent frameworks are supported?
What agent frameworks are supported?
- LangGraph (primary): Full support for graph definitions, checkpointing, memory, and streaming
- Google ADK (Agent Development Kit): Support for agent definitions, session services, and memory services
agent.type config field. Each framework has its own adapter in the engine that handles initialization, execution, and streaming. See Frameworks for details.How does authentication work?
How does authentication work?
IDUN_ADMIN_AUTH_MODE:none: open admin (laptop default).password: bcrypt password + signed session cookie with sliding renewal.
idun hash-password to generate the bcrypt hash, set it as IDUN_ADMIN_PASSWORD_HASH on first boot, and set IDUN_SESSION_SECRET (min 32 chars) when running in password mode.Agent runtime routes. The engine can enforce OIDC JWT validation on /agent/* via a per-agent SSO config. Clients must present a valid bearer token; tokens are not stored. Some operational endpoints stay outside per-agent auth, so deploy inside a trusted network boundary and follow the hardening guidance.See Authentication for setup instructions.Does Idun require a database?
Does Idun require a database?
DATABASE_URL. Without a DB the standalone has nowhere to persist admin edits, traces, or session cookies.Engine-only. No database required. The engine reads its YAML config at boot and serves the agent. Conversation state is whatever you configure for the LangGraph checkpointer (in-memory, SQLite file, or Postgres) or the ADK session service. With in_memory, nothing is persisted.Where is data stored?
Where is data stored?
- Agent code: Lives in your repository. The engine wraps your code at runtime; it does not copy or store it.
- Standalone: Admin state (agent config, prompts, guardrails, MCP servers, observability, integrations, theme) and trace events live in the local database (SQLite by default, Postgres optional).
- Engine-only: Configuration comes from a YAML file. Conversation state goes to whichever checkpointer or session service you configure.
Can I run without the admin DB?
Can I run without the admin DB?
idun serve (or idun init) gives you, and it does require a DB.How do guardrails work?
How do guardrails work?
- Input guardrails check user messages before they reach the agent (e.g., jailbreak detection, PII detection)
- Output guardrails check agent responses before they are returned to the user (e.g., toxic language filtering, topic restriction)
BAN_LIST, DETECT_PII, TOXIC_LANGUAGE, DETECT_JAILBREAK, PROMPT_INJECTION, RESTRICT_TO_TOPIC, MODEL_ARMOR (Google Cloud), and CUSTOM_LLM. See the guardrails reference for the full list.Engine-only vs standalone, what's the difference?
Engine-only vs standalone, what's the difference?
idun-agent-engine wheel. Pick by which command you run. See the glossary for the package layout.Is it free and open source?
Is it free and open source?
idun-agent-engine) and schema library (idun-agent-schema) are published to PyPI.Does GPLv3 apply to my agent code?
Does GPLv3 apply to my agent code?
- Your agent's graph_definition
- MCP servers and external tools
- LLM-generated code
agent.config.graph_definition and runs it in the same Python process. The FSF considers in-process Python imports across a clean API boundary to be a closer relationship than mere aggregation, so a strictly conservative reading would treat your agent code as a derivative work subject to GPL.In practice, most teams treat their agent code as a separate work because:- The interaction is through a documented public extension point (
BaseAgent, schema config fields), not internal engine APIs. - Your agent code can be loaded into other runtimes without modification.
- You ship your agent as code that the user combines with the engine, not as a bundled binary.
idun-agent-engine (a single wheel, container image, or installer) and your agent code is not GPL-compatible, get legal advice before shipping.Running the engine privately (internally, on your own infrastructure, with your own users) imposes no GPL distribution obligations.How do I report a bug or request a feature?
How do I report a bug or request a feature?
- Bugs and feature requests: GitHub Issues
- Questions and discussions: Discord
How does observability work?
How does observability work?
Can I use multiple MCP servers with one agent?
Can I use multiple MCP servers with one agent?