面向持久化多智能体、多会话系统的开放基础设施。
我们构建显式定义于 Python、可在生产环境中恢复，并能从工作流定义一路检查到最终 Artifact 的智能体运行时。
网站 · 文档 · OpenRath · 示例 · PyPI · 论文
English | 简体中文
OpenRath 是一个持久化、 类 PyTorch 的多智能体与多会话系统运行时。
OpenRath v2.0.0 标志着 OpenRath 正式进入生产环境。它将显式的 @step 和
@router 工作流边界编译为不可变执行计划，并跨 Worker 重启持久化 Run、
Event、Checkpoint、Interrupt 和副作用结果。
@step / @router
|
v
ExecutionPlan -> Run -> Event -> Checkpoint
| |
| +-> Interrupt / Effect Ledger
|
+-> 嵌入式 SQLite
+-> PostgreSQL + 可选 Redis + S3 兼容 Artifact 存储
|
v
Agent Server HTTP + SSE
v1 Python 门面仍然可用：Session 携带智能体状态，Sandbox 控制执行位置，
Memory 持久化知识，Tool 暴露操作，Agent 与 Workflow 组合行为。
| 仓库 | 用途 | 从这里开始 |
|---|---|---|
| OpenRath | 运行时、Python SDK、Agent Server、部署参考、测试和发布证据 | pip install openrath |
| OpenRath-Docs | 与版本匹配的概念、教程、API 参考、迁移、安全和运维指南 | docs.openrath.com |
| OpenRath-Example | 可直接运行的文献研究、PowerPoint 创建和 Excel 可视化 Colab 工作流 | 在 Colab 中打开 |
框架仓库还包含一套 12 步核心 API 学习阶梯。 使用它逐项学习概念；使用 OpenRath-Example 检查完整的持久化工作流及其最终交付物。
- 显式状态。 工作流、Session、Plan、Revision、Run 与 Effect 都是可检查对象， 而不是隐藏在循环中的状态。
- 持久化恢复。 Checkpoint、Lease、Fencing、Retry、Cancellation 与 Interrupt 让故障和人工决定成为运行时模型的一部分。
- 安全边界。 身份验证、Action Grant、Tenant Scope、Policy、Secret Reference、 Trust Label 与 Audit 是彼此独立的契约。
- 可组合基础设施。 Provider、Tool/MCP、Sandbox、Memory、存储、Artifact、 遥测和评估系统通过受治理的接口接入。
- 证据驱动发布。 不可变 Artifact、迁移、测试、SBOM、扫描、基准测试、 Soak Report 与恢复演练均绑定至源码 Revision。
安装 OpenRath：
pip install openrath先使用 SQLite 在本地运行持久化工作流，再迁移至采用 PostgreSQL 的 Agent Server Profile：
pip install "openrath[server,postgres]"
openrath-migrate
openrath-migrate --check选择下一步：
欢迎提出问题、设计想法、Bug 报告和 Pull Request。