---
id: ag-ui-adk
version: "0.7.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# ag_ui_adk — ADK Middleware for AG-UI Protocol

License: permissive · Maintenance: active · Downloads: 169.2K/mo

## What it is and what it does

ag-ui-adk is a Python middleware that connects Google's ADK (Agent Development Kit) agents to the AG-UI Protocol, a framework for building agent-driven UIs. It translates between ADK's agent execution model and AG-UI's event-streaming interface, allowing ADK agents to power interactive frontends. The middleware handles async execution, tool invocation, and human-in-the-loop workflows where agents pause for user approval before resuming.

The package provides two main integration paths: direct usage for embedding agents in Python code, and a FastAPI endpoint for server-based deployments. It depends on fastapi, aiohttp, uvicorn, pydantic, and other async-capable libraries. The middleware is actively maintained, has no known vulnerabilities, and is designed for developers building agent-driven applications that need to bridge ADK's agent capabilities with AG-UI's protocol.

Use it for:

- Deploying a Google ADK agent as a FastAPI service that streams events to an AG-UI frontend.
- Building human-in-the-loop workflows where an ADK agent pauses for user approval before executing tools.
- Integrating Gemini-powered agents into web applications using AG-UI's protocol and Dojo interface.
- Running multiple ADK agents with session management and per-user context isolation.
- Developing agent-driven UIs that combine ADK's tool calling with AG-UI's event-driven architecture.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Bridges Google ADK agents to the AG-UI Protocol, enabling ADK-built agents to run within AG-UI's framework via middleware that handles async event streaming and tool integration.

Yes. The package is actively maintained, has no security vulnerabilities, low install friction, and a permissive MIT license. Install it if you are building an agent application that needs to bridge Google ADK agents with AG-UI's protocol—it is purpose-built for that integration. If you are not using both ADK and AG-UI, it is not applicable.

## Install

pip install ag-ui-adk
uv add ag-ui-adk
poetry add ag-ui-adk

## Installing ag_ui_adk

Before you install: Low friction install with a pure-Python wheel. Active maintenance (last commit 2026-08-14) and recent releases. Depends on 10 runtime packages including fastapi, aiohttp, and uvicorn; all are standard, well-maintained libraries.

License in practice: MIT license permits commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install ag-ui-adk

from ag_ui_adk import ADKAgent
from google.adk.agents import Agent

my_agent = Agent(name="assistant", instruction="You are helpful.")
agent = ADKAgent(adk_agent=my_agent, app_name="my_app", user_id="user123")

async for event in agent.run(input_data):
    print(f"Event: {event.type}")

Requires Python 3.10 or later (supports up to 3.14). Requires a Gemini API key exported as GOOGLE_API_KEY environment variable to run examples.

Verify before relying:

- Whether the 271 comprehensive tests mentioned in the description are included in the PyPI distribution or only in the source repository.
- Performance characteristics and scalability limits for concurrent agent runs or high-volume tool calls.
- Whether ResumabilityConfig (HITL workflows) requires google-adk >= 1.16.0 as stated, and what happens if an older version is installed.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 169.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google adk ag-ui integration, adk agent middleware, ag-ui protocol bridge, adk fastapi server, adk agent framework, agent-framework, google-adk, ai-integration

[View on SkillFed](https://skillfed.io/packages/ag-ui-adk) · [View on PyPI](https://pypi.org/project/ag-ui-adk/)