ag_ui_adk

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 on this page — 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

ag-ui-adk on PyPI

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

Evidence: ag_ui_adk-0.7.0-py3-none-any.whl

Tags

More Application Frameworks packages