Introduction

Aegra is an open-source, self-hosted Agent Protocol server that lets you run AI agents on your own infrastructure. It’s a drop-in replacement for LangSmith Deployments — same SDK, same APIs, no vendor lock-in. Read why teams choose Aegra over managed platforms, or jump straight to the migration guide if you’re switching.

Before you begin

Using an AI coding tool? Copy the prompt below to add the Aegra skill and MCP server for better results when building with Aegra.

Show Install the Aegra skill and MCP server

Install the Aegra skill to get context on project structure, configuration, and best practices:

npx skills add https://docs.aegra.dev

Then add the Aegra MCP server for access to documentation search. Follow the setup instructions for your tool:

Claude Code
Cursor
VS Code
llms.txt

claude mcp add --transport http aegra-docs https://docs.aegra.dev/mcp

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "aegra-docs": {
      "url": "https://docs.aegra.dev/mcp"
    }
  }
}

Add to your .vscode/mcp.json:

{
  "servers": {
    "aegra-docs": {
      "type": "http",
      "url": "https://docs.aegra.dev/mcp"
    }
  }
}

Feed https://docs.aegra.dev/llms.txt to any LLM for full docs context.

What Aegra does

Aegra gives you a production-ready server for running LangGraph agents with full persistence, streaming, and authentication. You bring your own PostgreSQL database and keep complete control over your data.

Agent Protocol

Works with Agent Chat UI, LangGraph Studio, and CopilotKit out of the box.

Self-hosted

Run on your own infrastructure with your own PostgreSQL database. No external dependencies.

Same SDK

Use the LangGraph SDK you already know. Switch from LangSmith Deployments with zero code changes.

Open source

Apache 2.0 licensed. Inspect, modify, and contribute to the codebase.

How it compares

	LangSmith Deployments	Aegra
Deploy agents	Local dev only (Free), paid cloud (Plus)	Free, unlimited
Custom auth	Not available (Free), available (Plus)	Python handlers (JWT/OAuth/Firebase)
Self-hosted	Enterprise only (license key required)	Always (Apache 2.0)
Own database	Managed only (Free/Plus), bring your own (Enterprise)	Bring your own Postgres
Tracing	LangSmith only	Any OTLP backend (Langfuse, Phoenix, etc.)
Data residency	LangChain cloud (Free/Plus), your infrastructure (Enterprise)	Your infrastructure
SDK	LangGraph SDK	Same LangGraph SDK

Based on LangChain pricing as of February 2026. An enterprise tier with self-hosting is also available at custom pricing. See the full feature support matrix for what Aegra supports today.

Key features

Human-in-the-loop — Approval gates and user intervention points
Streaming — Real-time responses with network resilience
Persistent state — PostgreSQL checkpoints via LangGraph
Configurable auth — JWT, OAuth, Firebase, or none
Observability — Fan-out tracing via OpenTelemetry to multiple backends
Semantic store — Vector embeddings with pgvector
Custom routes — Add your own FastAPI endpoints alongside the Agent Protocol API

Next steps

Quickstart

Get a running server in under 5 minutes.

Build your first agent

Hands-on tutorial from zero to a working agent.

Installation

All the ways to install and run Aegra.

Why Aegra

Cost comparison and feature highlights.

Migrate from LangSmith

Step-by-step guide to switching from LangSmith Deployments.

Documentation Index

​Before you begin

​What Aegra does

Agent Protocol

Self-hosted

Same SDK

Open source

​How it compares

​Key features

​Next steps

Quickstart

Build your first agent

Installation

Why Aegra

Migrate from LangSmith

Before you begin

What Aegra does

How it compares

Key features

Next steps