Skip to main content
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: