---
id: agent-framework-ag-ui
version: "1.1.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# agent-framework-ag-ui — AG-UI protocol integration for Agent Framework

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

## 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 above — 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

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

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

## Tags

ag-ui agent framework integration, fastapi agent web interface, streaming agent protocol, agent framework server setup, async agent client, workflow web ui integration, agent framework ag-ui, agent-framework, web-ui-integration, streaming-protocol

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