Skip to content

v0.6.0 - Major update

Choose a tag to compare

View all tags
@Freezaa9 Freezaa9 released this 17 May 17:09
· 238 commits to main since this release
v0.6.0
2dabd50
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Idun Engine v0.6.0 — The third path

The release where Idun Engine becomes the third path between LangGraph Cloud and DIY. One pip install ships your LangGraph or Google ADK agent as a production-ready FastAPI service — bundled chat UI, admin panel, traces viewer, 15+ guardrails, multi-provider observability via OpenTelemetry, MCP tool governance, 5 memory backends, and OIDC. Self-hosted, open source, no vendor lock-in.

📖 Full launch context: The third path — blog post
📋 Full changelog: docs.idun-group.com/changelog

Install

pip install idun-agent-engine==0.6.0
idun setup
idun serve

Open http://localhost:8000 — your agent runs at /, admin at /admin, traces at /admin/traces.

Highlights

  • One wheel, three services collapsed. idun-agent-manager (FastAPI) + idun-agent-web (React) services are gone. The Next.js admin / chat / traces UI is now bundled directly into the idun-agent-engine wheel. ~151,820 lines deleted in one cut (commit 9a54145d).
  • Standards composed, not invented. AG-UI streaming (CopilotKit-compatible), OpenTelemetry tracing across 5 providers, MCP tool servers (under Linux Foundation governance since 2025), OIDC auth (Google + Microsoft).
  • Traces v1 lands. Trace store (asyncpg COPY), REST endpoints, list + detail UI with span tree and waterfall. ADK spans projected to OpenInference attributes so they flow through the same pipeline as LangGraph spans.
  • Brand + docs rebrand. "Idun Platform" → "Idun Engine" across the public surface. Docs moved to docs.idun-group.com with paper/ink editorial design.

What's added

  • Bundled Next.js admin / chat / traces UI (services/idun_agent_standalone_ui/)
  • Traces v1: schema + asyncpg writer + REST + UI (list + detail with span tree / waterfall)
  • ADK → OpenInference attribute projection (observability/projection.py)
  • /admin activity dashboard: traces-driven KPIs across 24h/7d/30d, RPM sparkline, p50/p95 latency, top-errors
  • LangGraph auto-detection scanner — infers graph_definition from known factories + CompiledStateGraph annotations
  • get_langchain_tools_sync() — MCP tools at module-load (synchronous contexts like create_deep_agent)
  • Microsoft OIDC alongside Google
  • Google Chat integration (joins WhatsApp, Discord, Slack, Teams)
  • SSE / HTTP transport for ADK MCP toolsets
  • Real-LLM end-to-end test suite (LangGraph + ADK + Playwright)
  • PostHog telemetry + masked session replay (opt-in)
  • Standalone seeder persists all top-level YAML config blocks on first boot
  • BaseAgent.register_run_event_observer(observer) — async callbacks receive every AG-UI event before SSE encoding

What's changed

  • The engine wheel bundles standalone + schema. pip install idun-agent-engine ships the idun console script, the Next.js bundle, alembic migrations, and idun-agent-schema as a runtime dependency.
  • guardrails-ai is now an optional extra ([guardrails]). Install with pip install idun-agent-engine[guardrails]==0.6.0 if you use Guardrails-AI.
  • Secure-by-default host binding. idun serve no longer binds 0.0.0.0 by default.
  • ObservabilityConfig schema restructured (discriminated union now stamps provider literal onto each inner config; legacy YAML keeps working).
  • AdkAgentConfig.app_name now optional — auto-derived from name when omitted.

⚠️ Breaking changes

  • RestrictToTopicConfig.topics split into valid_topics + invalid_topics. v0.5.x configs using topics: will fail validation; rename the key in your YAML.
  • Haystack adapter removed. framework: HAYSTACK no longer accepted. Migrate Haystack agents to LangGraph or ADK before upgrading.
  • TUI (idun init Textual UI) removed. Replaced by the setup wizard inside the bundled Next.js admin at /admin.

Upgrading from 0.5.x

  1. Uninstall any separate idun-agent-standalone wheel — it's now bundled in the engine wheel.
  2. pip install idun-agent-engine[guardrails]==0.6.0 if you use Guardrails-AI; otherwise plain pip install idun-agent-engine==0.6.0.
  3. Migrate Haystack agent configs to LangGraph or ADK.
  4. Rename topics: → valid_topics: / invalid_topics: in any RestrictToTopicConfig YAML.
  5. Switch smoke checks from curl /health to POST /agent/run (the deprecated /agent/invoke still works but will be removed in 0.7).
  6. Run idun setup after upgrade so the new standalone admin DB migrations apply.
  7. Point docs.idunplatform.com references at docs.idun-group.com.

⚠️ Known issue — upstream PyPI quarantine

The guardrails-ai package is currently in PyPI quarantine (since 2026-05-12). Until PyPI admins lift the quarantine, pip install idun-agent-engine[guardrails]==0.6.0 will fail at the guardrails-ai dependency. The base pip install idun-agent-engine==0.6.0 is unaffected. Track upstream: guardrails-ai on PyPI.

Standards composed

LangGraph · Google ADK · AG-UI · OpenTelemetry · MCP · OIDC · FastAPI · Pydantic

Source: GitHub · Docs: docs.idun-group.com · Community: Discord · Book a call: calendar.app.google

🤖 Release notes prepared with Claude Code

Assets 2
Loading