Add README files to all packages (#180)

Author: mme

python-sdk/README.md

@@ -1,5 +1,57 @@
-# Agent User Interaction Protocol Documentation
+# ag-ui-protocol
 
-The Python SDK for the [Agent User Interaction Protocol](https://ag-ui.com).
+Python SDK for the **Agent-User Interaction (AG-UI) Protocol**.
 
-For more information visit the [official documentation](https://docs.ag-ui.com/).
+`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
+
+```bash
+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
+
+```python
+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 protocol
+- **`ag_ui.encoder`** – Event encoding utilities for HTTP streaming
+
+## Documentation
+
+- Concepts & architecture: [`docs/concepts`](https://docs.ag-ui.com/concepts/architecture)
+- Full API reference: [`docs/sdk/python`](https://docs.ag-ui.com/sdk/python/core/overview)
+
+## Contributing
+
+Bug reports and pull requests are welcome! Please read our [contributing guide](https://docs.ag-ui.com/development/contributing) first.
+
+## License
+
+MIT © 2025 AG-UI Protocol Contributors

typescript-sdk/integrations/agno/README.md

@@ -0,0 +1,36 @@
+# @ag-ui/agno
+
+AG-UI integration for **Agno** - Multi-Agent Systems framework with memory, knowledge and reasoning.
+
+Connects Agno agents to frontend applications via the AG-UI protocol using HTTP communication.
+
+## Installation
+
+```bash
+npm install @ag-ui/agno
+pnpm add @ag-ui/agno
+yarn add @ag-ui/agno
+```
+
+## Usage
+
+```ts
+import { AgnoAgent } from "@ag-ui/agno";
+
+// Create an AG-UI compatible agent
+const agent = new AgnoAgent({
+  url: "https://your-agno-server.com/agent",
+  headers: { Authorization: "Bearer your-token" },
+});
+
+// Run with streaming
+const result = await agent.runAgent({
+  messages: [{ role: "user", content: "Hello from Agno!" }],
+});
+```
+
+## Features
+
+- **HTTP connectivity** – Direct connection to Agno agent servers
+- **Multi-agent support** – Works with Agno's multi-agent system architecture
+- **Streaming responses** – Real-time communication with full AG-UI event support

typescript-sdk/integrations/agno/package.json

@@ -7,7 +7,8 @@
   "types": "./dist/index.d.ts",
   "sideEffects": false,
   "files": [
-    "dist/**"
+    "dist/**",
+    "README.md"
   ],
   "private": false,
   "publishConfig": {

typescript-sdk/integrations/crewai/README.md

@@ -1,13 +1,44 @@
-# Server Starter
+# @ag-ui/crewai
 
-This starter kit demonstrates sending the minimal set of events that are needed to stream data from the agent to the frontend.
+AG-UI integration for **CrewAI** - Sequential multi-agent workflows and collaborative agent teams.
 
-## Running the server
+Connects CrewAI Flows and Crews to frontend applications via the AG-UI protocol. Supports both TypeScript HTTP clients and Python FastAPI server integration with streaming crew execution.
 
-To run the server:
+## Installation
 
 ```bash
-cd typescript-sdk/integrations/server-starter/server/python
+npm install @ag-ui/crewai
+pnpm add @ag-ui/crewai
+yarn add @ag-ui/crewai
+```
+
+## Usage
+
+```ts
+import { CrewAIAgent } from "@ag-ui/crewai";
+
+// Create an AG-UI compatible agent
+const agent = new CrewAIAgent({
+  url: "http://localhost:8000/crew-endpoint",
+  headers: { "Content-Type": "application/json" },
+});
+
+// Run with streaming
+const result = await agent.runAgent({
+  messages: [{ role: "user", content: "Execute the research crew" }],
+});
+```
+
+## Features
+
+- **HTTP connectivity** – Connect to CrewAI FastAPI servers
+- **Flow & Crew support** – Works with both CrewAI Flows and traditional Crews
+- **Step tracking** – Real-time crew execution progress
+- **Python integration** – Full FastAPI server implementation included
 
+## To run the example server in the dojo
+
+```bash
+cd typescript-sdk/integrations/crewai/python
 poetry install && poetry run dev
 ```

typescript-sdk/integrations/crewai/package.json

@@ -7,7 +7,8 @@
   "types": "./dist/index.d.ts",
   "sideEffects": false,
   "files": [
-    "dist/**"
+    "dist/**",
+    "README.md"
   ],
   "private": false,
   "publishConfig": {

typescript-sdk/integrations/crewai/python/README.md

@@ -0,0 +1,59 @@
+# ag-ui-crewai
+
+AG-UI integration for **CrewAI** - Build powerful agent workflows and multi-agent crews with LLMs.
+
+Provides a complete Python integration for CrewAI flows and crews with the AG-UI protocol, including FastAPI endpoint creation and comprehensive event streaming.
+
+## Installation
+
+```bash
+pip install ag-ui-crewai
+```
+
+## Usage
+
+```python
+from crewai.flow.flow import Flow, start
+from litellm import completion
+from ag_ui_crewai import (
+    add_crewai_flow_fastapi_endpoint,
+    copilotkit_stream,
+    CopilotKitState
+)
+from fastapi import FastAPI
+
+class MyFlow(Flow[CopilotKitState]):
+    @start()
+    async def chat(self):
+        response = await copilotkit_stream(
+            completion(
+                model="openai/gpt-4o",
+                messages=[
+                    {"role": "system", "content": "You are a helpful assistant."},
+                    *self.state.messages
+                ],
+                tools=self.state.copilotkit.actions,
+                stream=True
+            )
+        )
+        self.state.messages.append(response.choices[0].message)
+
+# Add to FastAPI
+app = FastAPI()
+add_crewai_flow_fastapi_endpoint(app, MyFlow(), "/flow")
+```
+
+## Features
+
+- **Native CrewAI integration** – Direct support for CrewAI flows, crews, and multi-agent systems
+- **FastAPI endpoint creation** – Automatic HTTP endpoint generation with proper event streaming
+- **Predictive state updates** – Real-time state synchronization between backend and frontend
+- **Streaming tool calls** – Live streaming of LLM responses and tool execution to the UI
+
+## To run the dojo examples
+
+```bash
+cd python/ag_ui_crewai
+poetry install
+poetry run dev
+```

typescript-sdk/integrations/crewai/python/pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 name = "ag-ui-crewai"
 version = "0.1.3"
-description = ""
+description = "AG-UI integration for CrewAI - Build powerful agent workflows and multi-agent crews with LLMs"
 authors = ["Markus Ecker <[email protected]>"]
 readme = "README.md"
 exclude = [

typescript-sdk/integrations/langgraph/README.md

@@ -0,0 +1,45 @@
+# @ag-ui/langgraph
+
+AG-UI integration for **LangGraph** - Build agent-native applications with shared state and human-in-the-loop workflows.
+
+Connects LangGraph graphs to frontend applications via the AG-UI protocol. Supports both local TypeScript graphs and remote LangGraph Cloud deployments with full state management and interrupt handling.
+
+## Installation
+
+```bash
+npm install @ag-ui/langgraph
+pnpm add @ag-ui/langgraph
+yarn add @ag-ui/langgraph
+```
+
+## Usage
+
+```ts
+import { LangGraphAgent } from "@ag-ui/langgraph";
+
+// Create an AG-UI compatible agent
+const agent = new LangGraphAgent({
+  graphId: "my-graph",
+  deploymentUrl: "https://your-langgraph-deployment.com",
+  langsmithApiKey: "your-api-key",
+});
+
+// Run with streaming
+const result = await agent.runAgent({
+  messages: [{ role: "user", content: "Start the workflow" }],
+});
+```
+
+## Features
+
+- **Cloud & local support** – Works with LangGraph Cloud and local graph instances
+- **State management** – Bidirectional state synchronization with graph nodes
+- **Interrupt handling** – Human-in-the-loop workflow support
+- **Step tracking** – Real-time node execution progress
+
+## To run the example server in the dojo
+
+```bash
+cd typescript-sdk/integrations/langgraph/examples
+langgraph dev
+```

typescript-sdk/integrations/langgraph/package.json

@@ -10,7 +10,8 @@
     "access": "public"
   },
   "files": [
-    "dist/**"
+    "dist/**",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup",

typescript-sdk/integrations/langgraph/python/README.md

@@ -0,0 +1,40 @@
+# ag-ui-langgraph
+
+AG-UI integration for **LangGraph** - Build stateful, multi-actor applications with LLMs using graphs.
+
+Provides a complete Python integration for LangGraph agents with the AG-UI protocol, including FastAPI endpoint creation and comprehensive event streaming.
+
+## Installation
+
+```bash
+pip install ag-ui-langgraph
+```
+
+## Usage
+
+```python
+from langgraph.graph import StateGraph, MessagesState
+from langchain_openai import ChatOpenAI
+from ag_ui_langgraph import LangGraphAgent, add_langgraph_fastapi_endpoint
+from fastapi import FastAPI
+from my_langgraph_workflow import graph
+
+# Add to FastAPI
+app = FastAPI()
+add_langgraph_fastapi_endpoint(app, graph, "/agent")
+```
+
+## Features
+
+- **Native LangGraph integration** – Direct support for LangGraph workflows and state management
+- **FastAPI endpoint creation** – Automatic HTTP endpoint generation with proper event streaming
+- **Advanced event handling** – Comprehensive support for all AG-UI events including thinking, tool calls, and state updates
+- **Message translation** – Seamless conversion between AG-UI and LangChain message formats
+
+## To run the dojo examples
+
+```bash
+cd python/ag_ui_langgraph/examples
+poetry install
+poetry run dev
+```