How idun-group/idun-agent-platform works
Idun Agent Platform packages LangGraph and Google ADK agents as a self-hosted FastAPI runtime with chat, administration, persistence, traces, and policy/tool-management capabilities. The main workflow is configuring an agent, assembling its runtime configuration from stored settings, serving chat or messaging requests through the engine, and exposing administration and trace inspection through the bundled UI. The graph preserves README-documented capabilities, but several links to unsampled subsystems are documented at product level rather than verified from their implementation.
Main entry points: base.py Engine SDK · app.py Standalone app · page.tsx Admin and traces UI · engine_config.py Config assembler
Components 19
User experience
- Chat UI
services/idun_agent_standalone_ui/app/page.tsx - Admin and traces UI
services/idun_agent_standalone_ui/app/admin/page.tsx
Agent runtime
- Standalone app
libs/idun_agent_standalone/src/idun_agent_standalone/app.py - Engine SDK
libs/idun_agent_engine/src/idun_agent_engine/agent/base.py - LangGraph adapter
libs/idun_agent_engine/src/idun_agent_engine/agent/langgraph/langgraph.py - ADK adapter
libs/idun_agent_engine/src/idun_agent_engine/agent/adk/adk.py - Messaging integrations
libs/idun_agent_engine/src/idun_agent_engine/integrations
Agent management
- Admin REST API
libs/idun_agent_standalone/src/idun_agent_standalone/api/v1/routers - Config assembler
libs/idun_agent_standalone/src/idun_agent_standalone/services/engine_config.py - Runtime reload
libs/idun_agent_standalone/src/idun_agent_standalone/services/engine_reload.py - MCP tools
libs/idun_agent_engine/src/idun_agent_engine/mcp/registry.py - Guardrails
libs/idun_agent_engine/src/idun_agent_engine/guardrails - Prompt management
libs/idun_agent_engine/src/idun_agent_engine/prompts/registry.py
State and traces
- Observability providers
libs/idun_agent_engine/src/idun_agent_engine/observability - Standalone database
libs/idun_agent_standalone/src/idun_agent_standalone/infrastructure/db/session.py - Trace storage
libs/idun_agent_standalone/src/idun_agent_standalone/infrastructure/traces/writer.py
Configuration contracts
- Engine configuration
libs/idun_agent_schema/src/idun_agent_schema/engine/engine.py
Other components
- Chat users
- Administrators
Connections 22
- Chat users → Chat UI: use chat
README.md - Administrators → Admin and traces UI: manage runtime
README.md - Chat UI → Engine SDK: send requests
README.md - Admin and traces UI → Admin REST API: call API
- Standalone app → Engine SDK: mount runtime
README.md - Standalone app → Admin REST API: register routes
libs/idun_agent_standalone/src/idun_agent_standalone/app.py - Standalone app → Standalone database: read configuration
libs/idun_agent_standalone/src/idun_agent_standalone/app.py - Standalone app → Config assembler: assemble config
libs/idun_agent_standalone/src/idun_agent_standalone/app.py - Config assembler → Standalone database: load settings
libs/idun_agent_standalone/src/idun_agent_standalone/services/engine_config.py - Config assembler → Engine configuration: validate config
libs/idun_agent_standalone/src/idun_agent_standalone/services/engine_config.py - Admin REST API → Runtime reload: trigger reload
- Runtime reload → Engine SDK: reconfigure agent
libs/idun_agent_standalone/src/idun_agent_standalone/services/engine_reload.py - Engine SDK → LangGraph adapter: supports framework
README.md - Engine SDK → ADK adapter: supports framework
README.md - Engine SDK → MCP tools: govern tools
README.md - Engine SDK → Guardrails: apply policies
README.md - Engine SDK → Prompt management: use prompts
README.md - Engine SDK → Observability providers: emit traces
README.md - Engine SDK → Standalone database: persist memory
README.md - Messaging integrations → Engine SDK: invoke agent
libs/idun_agent_engine/src/idun_agent_engine/integrations/google_chat/handler.py - Observability providers → Trace storage: export trace data
- Admin and traces UI → Trace storage: inspect traces
README.md