agent-framework-ag-ui

What it is and what it does

Agent Framework AG-UI is a protocol bridge that lets you expose Agent Framework agents and workflows through a web interface via FastAPI. It handles the AG-UI streaming protocol, allowing you to build servers that host AI agents or multi-step workflows and clients that connect to them over HTTP with streaming support. The package provides high-level helpers like `add_agent_framework_fastapi_endpoint` to wire up a FastAPI app, `AGUIChatClient` for async client connections, and utilities like `state_update` for tools that need to send different payloads to the model, the UI, and shared state.

The package depends on fastapi, httpx, uvicorn, sse-starlette, and agent-framework-core, plus the ag-ui-protocol specification. It supports both simple agent hosting and stateful workflow patterns (including thread-scoped workflows for conversation isolation). It implements the canonical AG-UI interrupt protocol for tool approval and workflow input requests, allowing paused runs to be resumed with user decisions or edited arguments.

Use it for:

• Host an AI agent behind a FastAPI server and connect to it from a web client using AGUIChatClient with streaming responses.
• Build a multi-step workflow with AG-UI and expose it through a FastAPI endpoint for remote execution and state management.
• Implement tool approval workflows where the UI pauses execution, collects user approval or edited arguments, and resumes the agent.
• Create thread-scoped workflow instances to isolate conversation state and pending interrupts per user session.
• Render custom UI components for tool results using state_update to separate LLM-bound text from frontend-specific payloads.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Connects Agent Framework agents and workflows to AG-UI's web interface and streaming protocol, enabling FastAPI-based servers and async clients for agent-driven applications.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and integrates cleanly with FastAPI and Agent Framework. It is in production-stable status with no known vulnerabilities. Install it if you need to expose Agent Framework agents or workflows through a web interface with streaming and interrupt support.

Install

agent-framework-ag-ui on PyPI

pip install agent-framework-ag-ui

uv add agent-framework-ag-ui

poetry add agent-framework-ag-ui

Installing agent-framework-ag-ui

Before you install

Low friction install with a pure-Python wheel. Active maintenance with a recent release and 12804 repository stars. Supports Python 3.10 through 3.13.

License in practice

MIT license (permissive) allows use in commercial and private projects with minimal restrictions.

Quickstart

pip install agent-framework-ag-ui

from fastapi import FastAPI
from agent_framework import Agent
from agent_framework.ag_ui import add_agent_framework_fastapi_endpoint

agent = Agent(name="my_agent", instructions="You are helpful.")
app = FastAPI()
add_agent_framework_fastapi_endpoint(app, agent, "/")
# Run with: uvicorn main:app --reload

Requires Python 3.10 or later. Requires a configured agent-framework-core Agent or Workflow instance and a running FastAPI application.

Verify before relying

• Whether the package requires external AG-UI server infrastructure or if it is self-contained
• Performance characteristics under high concurrency or large message volumes
• Stability guarantees for the 1.1.0 release relative to the stated 1.0.0 target

Package facts

Evidence: agent_framework_ag_ui-1.1.0-py3-none-any.whl

Tags

More Application Frameworks packages

Further reading