Repository navigation
Turn agents into an API. You call an agent, not a model — with the official OpenAI, Claude or Gemini SDK, a Base URL and an API key.
This is the first public release, under Apache-2.0.
Downloads
| Platform | File |
|---|---|
| macOS, Apple silicon | Open-Agent-API-0.0.64-macOS-arm64.dmg |
| macOS, Intel | Open-Agent-API-0.0.64-macOS-x64.dmg |
| Windows x64 | Open-Agent-API-0.0.64-win-x64.zip |
Every package bundles its own Node.js runtime; nothing else needs to be installed. Verify downloads against SHA256SUMS.
- macOS: the app is not notarized by Apple. On first launch, open System Settings → Privacy & Security and choose Open Anyway. The command-line tool is inside the app:
/Applications/Open Agent API.app/Contents/Resources/oaa. - Windows: unzip, then run
oaa.cmd quickstart. SmartScreen may ask for confirmation because the scripts are unsigned.
First call in one command
oaa quickstartIt initializes, starts the gateway on 127.0.0.1, publishes an offline sample agent (it calls no model and costs nothing), creates a caller key, makes the first call, and prints a ready-to-paste curl and OpenAI SDK snippet. Then connect an agent you already have:
oaa connect codex # or: claude, antigravityWhat is in this release
- OpenAI Chat Completions and Responses, Claude Messages and Gemini
generateContententry points, served by the same agents. - Runs you can inspect: timeline, steps, approvals, cancel, continue.
- Console and CLI in English and Chinese; error messages follow
Accept-Language. - Developer portal with keys, usage and listings.
Known limits
- Verified end to end with a real agent only on Antigravity. Approvals and caller-side tools are verified with a local stand-in; Codex and Claude Code have not been verified with real calls yet.
- The Windows and Intel macOS packages passed automated smoke tests on build machines but have not been run by hand.
- The Claude Agent SDK is proprietary and not bundled;
oaa doctorexplains how to install it separately.
Full details: CHANGELOG · README
把智能体变成 API。 调用的是智能体而不是模型:用 OpenAI、Claude 或 Gemini 的官方 SDK,只需要 Base URL 和 API Key。
这是第一个公开版本,以 Apache-2.0 开源。
- 下载:上表三个安装包都自带 Node.js 运行时,不需要另装任何东西;可用
SHA256SUMS校验。 - macOS:应用没有经过苹果公证,首次打开请在「系统设置 → 隐私与安全性」里选择「仍要打开」。命令行工具在应用包里:
/Applications/Open Agent API.app/Contents/Resources/oaa。 - Windows:解压后运行
oaa.cmd quickstart;脚本没有签名,SmartScreen 可能会要求确认。 - 一条命令完成第一次调用:
oaa quickstart会初始化、在127.0.0.1启动网关、发布一个离线示例智能体(不调用模型、不花钱)、生成调用方密钥并完成第一次调用。之后用oaa connect codex(或claude、antigravity)接上你已有的智能体。 - 已知边界:真实智能体的端到端验证目前只在 Antigravity 上做过;审批与调用方工具是用本地替身验证的;Codex 和 Claude Code 还没有用真实调用验证。Windows 与 Intel Mac 的安装包通过了构建机上的自动烟雾测试,没有人工运行过。Claude Agent SDK 是专有许可,不随包分发。