ag-ui-protocol0.1.8
ag-ui-protocol0.1.8
Published
pip install ag-ui-protocol
Package Downloads
Authors
Requires Python
<4.0,>=3.9
Dependencies
ag-ui-protocol
Python SDK for the Agent-User Interaction (AG-UI) Protocol.
ag-ui-protocol
provides Python developers with strongly-typed data structures and event encoding for building AG-UI compatible agent servers. Built on Pydantic for robust validation and automatic camelCase serialization for seamless frontend integration.
Installation
pip install ag-ui-protocol
poetry add ag-ui-protocol
pipenv install ag-ui-protocol
Features
- 🐍 Python-native – Idiomatic Python APIs with full type hints and validation
- 📋 Pydantic models – Runtime validation and automatic JSON serialization
- 🔄 Streaming events – 16 core event types for real-time agent communication
- ⚡ High performance – Efficient event encoding for Server-Sent Events
Quick example
from ag_ui.core import TextMessageContentEvent, EventType
from ag_ui.encoder import EventEncoder
# Create a streaming text event
event = TextMessageContentEvent(
type=EventType.TEXT_MESSAGE_CONTENT,
message_id="msg_123",
delta="Hello from Python!"
)
# Encode for HTTP streaming
encoder = EventEncoder()
sse_data = encoder.encode(event)
# Output: data: {"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_123","delta":"Hello from Python!"}\n\n
Packages
ag_ui.core
– Types, events, and data models for AG-UI protocolag_ui.encoder
– Event encoding utilities for HTTP streaming
Documentation
- Concepts & architecture:
docs/concepts
- Full API reference:
docs/sdk/python
Contributing
Bug reports and pull requests are welcome! Please read our contributing guide first.
License
MIT © 2025 AG-UI Protocol Contributors