aegra

自托管 LangGraph 后端，数据自己管，不怕被锁定

aegra 是一个开源的 AI Agent 后端框架，定位为 LangGraph Platform（现 LangSmith Deployments）的自托管替代方案。它解决的核心问题是：使用 LangGraph 构建 Agent 时，官方托管平台会带来厂商锁定、成本不可控和数据外流风险。aegra 用 FastAPI 提供 API 层、PostgreSQL 做状态与持久化存储，让你在自己的服务器上跑完整的 Agent 服务，包括对话线程管理、状态持久化、流式输出等能力。项目基于 Python 与 LangGraph 生态，可直接复用现有 LangGraph 图定义，迁移成本低。对于需要私有化部署、对数据合规有要求、或想避免按量付费的团队，aegra 提供了可控、可审计、零厂商锁定的基础设施选择。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1208

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开发框架

开发团队aegra

所属国家

官网地址https://aegra.dev

GitHubhttps://github.com/aegra/aegra

定价模式free

价格说明开源免费，可自托管

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型fastapi,langchain,langggraph,langgraph-agents,langgraph-platform-alternative,opensource-langgraph-platform,postgres,python

GitHub 星标★ 1208

30天Star增速

HF 下载量

上线时间2025-07-20 00:00:00

最近更新2026-09-20 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-13

浏览次数6

使用教程

难度：进阶约 10 分钟部署方式：本地安装 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 运行环境（README 提到项目基于 Python，PyPI 上发布了 aegra-api 与 aegra-cli 两个包）
PostgreSQL 数据库（项目用 PostgreSQL 做状态与持久化存储）
能访问 GitHub（https://github.com/aegra/aegra）与官网 https://aegra.dev 以获取完整文档
已有的 LangGraph 图定义（如需迁移现有 Agent，README 说明可直接复用）

安装与启动步骤

1查阅官方文档

README 节选只到 Quick Start 标题，安装命令需打开仓库或官网的快速开始章节按官方指引执行。
2获取项目源码

从 GitHub 克隆仓库到本地，作为自托管部署的起点；具体安装方式以仓库内文档为准。
```
git clone https://github.com/aegra/aegra.git
```
3准备 Python 环境

项目为 Python 生态，建议先建虚拟环境再安装依赖，README 未指定 Python 版本，以官方文档为准。
```
python -m venv .venv
```
4启动 PostgreSQL

aegra 依赖 PostgreSQL 保存线程状态与持久化数据，需先保证数据库可用；连接参数见官方文档。
5按官方说明启动服务

使用 README/官网给出的 CLI 或 API 启动命令运行服务，不要自行猜测端口与参数。

如何确认成功

README 未给出明确验证方式；请按官方 Quick Start 完成启动后，用其提供的接口或 CLI 命令确认服务可访问。

常见问题

Q：aegra 和 LangGraph Platform / LangSmith Deployments 是什么关系？

A：README 定位它为自托管替代方案，目标是让你用自己的基础设施运行 Agent 服务，避免厂商锁定、成本不可控与数据外流。

Q：已有的 LangGraph 代码需要重写吗？

A：项目简介说明可直接复用现有 LangGraph 图定义，迁移成本较低，具体接入方式见官方文档。

Q：必须用 PostgreSQL 吗？

A：项目技术栈中以 PostgreSQL 做状态与持久化存储，属于必需组件，部署前请先准备好数据库。

Q：为什么教程里没有具体安装命令？

A：本次提供的 README 节选只包含徽章和 Quick Start 标题，未给出安装命令，为避免误导未编造命令。

注意事项

本教程依据的 README 节选不完整，Quick Start 正文缺失，实际命令请以 https://github.com/aegra/aegra 和 https://aegra.dev 的官方文档为准。
PyPI 上可查到 aegra-api 与 aegra-cli 两个包名，但安装与启动命令请确认官方写法后再执行。
自托管服务涉及数据库与可能的模型密钥，请勿将敏感配置提交到代码仓库。

核心亮点

基于 FastAPI + PostgreSQL，技术栈主流，团队上手和二次开发成本低
直接兼容 LangGraph 图定义，迁移官方平台代码改动小
自托管部署，数据不出内网，无按量计费，适合合规与成本敏感场景

不足之处

生态与周边工具（监控、评测、可视化）相比官方平台仍不完善
项目处于成长早期，生产环境大规模验证案例有限

适用场景

企业内部需要私有化部署 AI Agent，数据不能出内网
用 LangGraph 开发但不想承担官方平台按量费用
需要完全掌控 Agent 后端，做深度定制和二次开发

替代项目

LangGraph Platform、Dify、Flowise

项目介绍

aegra 是开发框架领域的开源项目，由 aegra 开发，2025 年首次发布。

在全站 12,822 个收录项目中，它的 GitHub 星标数（1,208）位列前 30%，在开发框架分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-20。开源免费，可自托管。

它主要面向的使用场景是：企业内部需要私有化部署AIAgent，数据不能出内网。同类可对比的替代方案包括 LangGraph Platform、Dify、Flowise。

上一篇：maplibre-agent-skills

下一篇：generative-ai-cdk-constructs