If you already have an agent built with any framework (LangGraph, CrewAI, or your own custom implementation), you can deploy it to Agent Stack by wrapping it with the Agent Stack server.
This gives you instant access to the Agent Stack UI, observability features, and deployment infrastructure without rewriting your agent logic.
Prerequisites
- Agent Stack installed (Quickstart)
- An existing agent implementation
- Python 3.12+ environment
How It Works
The Agent Stack server wraps your existing agent code and exposes it through the A2A protocol. Your agent logic stays exactly the same - you just add a thin server wrapper that handles:
- Protocol translation (A2A)
- Auto-registration with Agent Stack
- Session management
- Extension support
Quick Start
1. Install the SDK
If you are starting a new uv project, run uv init to set up the project structure before adding packages.
2. Create a Server Wrapper
Create a new file (e.g., server.py) that wraps your existing agent:
3. Run Your Server
Your agent will automatically register with Agent Stack!
Enable auto-reload during development: Add watchfiles to automatically restart your server when code changes:
Advanced Implementations
Streaming Responses
If your agent generates responses incrementally, you can stream them:
With Context History
Access previous messages in the conversation: