aegra

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 276 🐛 待处理 161 👀 关注 11

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1306

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，可自托管

项目预览

项目数据

分类开发框架

开发团队aegra

官网地址https://aegra.dev

GitHubhttps://github.com/aegra/aegra

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

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

GitHub 星标★ 1306

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

代码更新2026-11-04

仓库体积4.5 MB

本站数据更新2026-11-05

维护状态活跃

收录时间2026-09-13

浏览次数8

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 1306

技术标签

fastapi langchain postgres python

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 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 两个包名，但安装与启动命令请确认官方写法后再执行。
自托管服务涉及数据库与可能的模型密钥，请勿将敏感配置提交到代码仓库。