ag-ui-protocol
Decision gist · record as of 2026-08-14
Yes, if you are building a Python agent server that must communicate with an AG-UI-compatible frontend. The package has low install friction, active maintenance, permissive MIT licensing, and no known vulnerabilities. The pre-1.0 version number warrants attention to release notes before upgrading, but the core offering is solid for its stated purpose.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Low install friction with a single runtime dependency (pydantic).
- Package is actively maintained with recent releases; supports current Python versions.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.
last release 2026-06-02 (73 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 7,407,094 downloads/mo, #1,744 on PyPI
Alternatives
Verify before relying
pip install ag-ui-protocol
from ag_ui_protocol import TextMessageContentEvent, EventType, EventEncoder
event = TextMessageContentEvent(
type=EventType.TEXT_MESSAGE_CONTENT,
message_id="msg_123",
delta="Hello from Python!"
)
encoder = EventEncoder()
sse_data = encoder.encode(event)- Whether the 16 core event types cover all use cases for your specific agent architecture.
- Performance characteristics and throughput limits for high-frequency streaming scenarios.
- Stability guarantees given the package is at version 0.1.19 (pre-1.0).
- Exact module structure and import paths for core types and encoder utilities.
What it is and what it does
ag-ui-protocol is a Python SDK that implements the Agent-User Interaction Protocol, providing strongly-typed Pydantic models for representing agent-server communication events and user messages. It handles encoding these structures with automatic camelCase conversion for frontend compatibility, and supports multimodal content including text, images, audio, video, and documents.
You would use this package when building a Python backend for an agent application that needs to stream real-time events to a frontend client following the AG-UI specification. The package abstracts away protocol details and serialization concerns, letting you work with idiomatic Python types while ensuring your messages conform to the expected wire format.
Use it for
- Build a Python agent server that streams events to a web frontend in real time.
- Encode multimodal user input into AG-UI-compliant message structures for agent processing.
- Implement Server-Sent Events streaming with automatic JSON serialization.
- Validate agent event payloads at runtime using Pydantic's type checking.
- Integrate with agent frameworks that need to emit AG-UI protocol events.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a Python agent server that must communicate with an AG-UI-compatible frontend.
The package has low install friction, active maintenance, permissive MIT licensing, and no known vulnerabilities. The pre-1.0 version number warrants attention to release notes before upgrading, but the core offering is solid for its stated purpose.
Install
ag-ui-protocol on PyPI
Before you install
Low install friction with a single runtime dependency (pydantic). Package is actively maintained with recent releases; supports current Python versions.
Requires Python 3.9 or later.
License in practice
MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.
Quickstart
pip install ag-ui-protocol
from ag_ui_protocol import TextMessageContentEvent, EventType, EventEncoder
event = TextMessageContentEvent(
type=EventType.TEXT_MESSAGE_CONTENT,
message_id="msg_123",
delta="Hello from Python!"
)
encoder = EventEncoder()
sse_data = encoder.encode(event)Verify before relying
- Whether the 16 core event types cover all use cases for your specific agent architecture.
- Performance characteristics and throughput limits for high-frequency streaming scenarios.
- Stability guarantees given the package is at version 0.1.19 (pre-1.0).
- Exact module structure and import paths for core types and encoder utilities.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepydantic |
| Maintenance | Actively maintained 73 days since the last release |
| First released | |
| Downloads | 7,407,094 / month, #1,744 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: ag_ui_protocol-0.1.19-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “agent-user interaction protocol”
- ag-ui-protocolProvides strongly-typed Python data structures and event encoding for…
- cosmpyCosmPy provides Python bindings to interact with Cosmos SDK-based…
- lean-lsp-mcpProvides an MCP server that exposes the Lean theorem prover to LLM…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also ag_ui_adk · ag-ui-langgraph · agent-framework-ag-ui · aiohttp-sse-client · pydantic-ai · langchain-protocol · aiohttp-sse-client2 · aegra-api · fasta2a · pydantic-deep