jonwiggins/optio

Optio – 可自托管的 AI 代理编排平台

它是什么 – Optio 是一个开源控制平面，让您能在自己的 Kubernetes 集群或开发者的笔记本电脑上，将 AI 驱动的代理（Claude Code、OpenAI Codex、GitHub Copilot、Gemini 等）作为会话运行。会话由五个简单属性（何时、何地、谁、什么、然后）定义，可以是从“将工单转为合并 PR”的一次性工作流程，到长效、消息驱动的代理群。

为什么重要 – 大多数商业“AI 代理”服务仅限 SaaS，将您锁定在单一模型中，并要求您将源代码和机密传送到第三方云端。Optio 将编排层置于您的基础设施内，提供单一 UI/API 来排程、触发和监控所有代理工作，并让您自由混搭任何您信任的供应商模型。

核心概念

概念	解释
Session	一个持久、可观察的工作单元，通过单一表单创建。表单捕捉 When（触发器）、Where（K8s pod 或本地机器）、Who（模型/执行环境）、What（提示词或模板）以及 Then（退出、等待或持久化）。
Feed	所有会话出现在同一个时间轴信息流中，具有统一的状态量表（needs-you → running → queued → … → done/failed）。
Reconciliation control plane	一个 Kubernetes 风格的循环，根据冻结的世界快照决定每个会话的下一个状态，并使用 compare-and-swap 应用变更，确保不会发生卡住的执行。
Persistent agents & swarms	在回合间保持状态、拥有收件箱，并能通过内部 HTTP API 互相传递消息的命名代理。适用于分派者-专家模式。
Connections (MCP)	预先配置的集成（Notion、Slack、Linear、GitHub、PostgreSQL、Sentry、自定义 HTTP API 等），在启动时注入 pod，赋予代理对外部工具安全、受限的访问权。

您现在可以做什么

Ticket → merged PR – 指派 GitHub/Linear/Jira 工单；Optio 部署一个 repo pod，运行所选模型，开启 PR，监控 CI，运行审查代理，并在绿灯时自动合并。
Scheduled / webhook jobs – 每日依赖审计、PagerDuty 分流、每周 Slack 报告、DB-to-Notion 查询，皆由 cron 或传入的 webhook 驱动。
Recurring blueprints – 将会话保存为蓝图，并在每个触发负载上自动执行。
Local automations – 在开发者工作站上运行代理（使用其自己的 CLI 登录），处理如 GitHub 审查请求或 Slack 提及等事件；机密永远不会离开机器。
Interactive terminals – 在浏览器或 iOS App 中开启模型支持的终端，获取实时日志，并在模型暂停等待输入时接收“needs-you”通知。
Agent swarms – 部署一个分派代理，将工作路由至专家代理，每个代理以其自己的 pod 生命周期模式（always-on, sticky, on-demand）运行。
Cost & usage tracking – UI 中显示每个会话的 token 使用量、模型特定限制以及每日成本明细。

架构概览

Control plane – 纯决策函数 (deriveKind)，将五个属性映射到具体的执行环境（repo pod, pooled pod, 或本地终端）。状态变更通过具有 CAS 更新和定期重新同步的 K8s 风格协调器流动。
Pod-per-repo model – 每个存储库一个长效 pod 持有 git 工作树；多个会话共享同一个 clone，减少启动时间并缓存工具。
Job pods – 为不需要存储库的会话（如审计、报告）提供的共享池化 pod。
Local daemon – optio local 在工作站上运行轻量级守护程序，向服务器公开 WebSocket，以便触发器能启动基于终端的代理。
Persistence – PostgreSQL 存储会话元数据、成本账本和 RBAC 定义；Redis 用于短暂队列和代理收件箱。
Security – AES-256-GCM 静态机密加密、OIDC/OAuth 和 GitHub-App 验证、Kubernetes RBAC 强制执行，以及可选的后量子安全 TLS。

谁应该考虑 Optio？

无法将代码或数据传送到外部 SaaS 的组织（金融、医疗、政府、国防）。
希望拥有单一内部“AI 工具”层，向开发者公开提示词、政策和连接的平台团队。
已经运行 Kubernetes 并寻找现成 Helm chart 的团队。
正在评估多个 LLM 供应商或构建多代理系统的公司。
希望在笔记本、集群和移动设备上拥有相同代理体验的开发者。

开始使用

Install – 通过提供的 Helm chart 部署（需要 K8s 集群、Postgres、Redis）。可选择在工作站上运行 optio local。
Configure connections – 一次性添加您的 GitHub、Slack、Notion 等凭证。
Create a session – 使用 Web UI 或 CLI 填写单一表单（何时/何地/谁/什么/然后）。
Watch – 信息流显示实时日志、成本和状态；交互式会话可从任何浏览器或 iOS App 接管。

TL;DR – Optio 是一个开源、可自托管的平台，让您能在自己的 Kubernetes 集群或笔记本上运行、排程和监控 AI 代理工作负载（PR 机器人、排程任务、交互式终端、持久代理群），同时将代码、机密和模型选择权掌握在自己手中。