Aegra

开源的 LangGraph Platform（现称为 LangSmith Deployments）替代方案 —— 基于 FastAPI 和 PostgreSQL 的自托管 AI Agent 后端。无厂商锁定，完全掌控你的 Agent 基础设施。

---

Aegra 是 LangSmith Deployments 的直接替代品。你可以使用相同的 LangGraph SDK 和 API，但将其运行在自己的基础设施上，并利用 PostgreSQL 进行持久化存储。

兼容组件： Agent Chat UI | LangGraph Studio | AG-UI / CopilotKit

🚀 快速开始

使用 CLI（推荐）

前提条件： Python 3.12+，Docker（用于 PostgreSQL）

pip install aegra-cli

# 初始化新项目 — 会提示选择位置、模板和名称
aegra init

# 按照打印的步骤操作：
cd <项目目录>
cp .env.example .env     # 在 .env 中添加你的 OPENAI_API_KEY
uv sync                  # 安装依赖
uv run aegra dev         # 启动 PostgreSQL + 开发服务器

注意： 请始终直接安装 aegra-cli，而不是 aegra 元包。PyPI 上的 aegra 包只是一个便捷包装器，不支持版本锁定。

从源码运行

git clone https://github.com/ibbybuilds/aegra.git
cd aegra
cp .env.example .env
# 在 .env 中添加你的 OPENAI_API_KEY

docker compose up

访问 http://localhost:2026/docs 以探索 API。

你现有的 LangGraph 代码无需修改即可运行：

from langgraph_sdk import get_client

client = get_client(url="http://localhost:2026")

assistant = await client.assistants.create(graph_id="agent")
thread = await client.threads.create()

async for chunk in client.runs.stream(
    thread_id=thread["thread_id"],
    assistant_id=assistant["assistant_id"],
    input={"messages": [{"type": "human", "content": "Hello!"}]},
):
    print(chunk)

🔥 为什么选择 Aegra？

基于 2026 年 2 月的 LangChain 定价。企业版自托管方案需另行定价。

	LangSmith Deployments	Aegra
部署 Agent	仅限本地开发（免费），云端付费（Plus）	免费，无限制
自定义认证	不可用（免费），可用（Plus）	Python 处理程序（JWT/OAuth/Firebase）
自托管	仅限企业版（需许可证密钥）	永久免费（Apache 2.0 协议）
自带数据库	仅托管服务（免费/Plus），自带（企业版）	支持自带 Postgres
追踪 (Tracing)	仅限 LangSmith	任何 OTLP 后端（Langfuse, Phoenix 等）
数据驻留	LangChain 云端，你的基础设施（企业版）	你的基础设施
SDK	LangGraph SDK	相同的 LangGraph SDK

✨ 功能特性

• 符合 Agent Protocol - 兼容 Agent Chat UI, LangGraph Studio, CopilotKit
• Human-in-the-loop - 支持审批门控和用户干预点
• 流式传输 - 具备网络弹性，支持实时响应
• 持久化状态 - 通过 LangGraph 实现 PostgreSQL 检查点存储
• 可配置认证 - 支持 JWT, OAuth, Firebase 或无认证
• 统一可观测性 - 通过 OpenTelemetry 支持扇出（Fan-out）追踪
• 语义存储 - 使用 pgvector 的向量嵌入存储
• 自定义路由 - 可添加你自己的 FastAPI 端点

🛠️ CLI 命令

aegra init              # 交互式命令 — 询问位置、模板和名称
aegra init ./my-agent   # 在指定路径创建（仍会询问模板）

aegra dev               # 启动开发服务器（支持热重载 + 自动 PostgreSQL）
aegra serve             # 启动生产服务器（无重载）
aegra up                # 构建并启动所有 Docker 服务
aegra down              # 停止 Docker 服务

aegra version           # 显示版本信息

📚 文档

docs.aegra.dev — 提供完整的操作指南、API 参考和配置说明。

主题	描述
快速开始	5 分钟内运行服务器
配置	aegra.json 格式及所有选项说明
认证	JWT, OAuth, Firebase 或自定义认证处理程序
流式传输	8 种 SSE 流模式，支持断线重连
存储	键值对与语义搜索存储
可观测性	扇出追踪至 Langfuse, Phoenix 或任何 OTLP 后端
部署	Docker, PaaS 及 Kubernetes 部署
迁移	从 LangSmith 迁移至 Aegra