项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2454
使用教程
环境要求
- Node.js 环境(用于 npm 全局安装 CLI)
- 使用 claude-code / gemini-cli / codex-cli 等 provider 时,本机需已安装并登录对应 CLI
- 使用 deepseek / openai 等 API key 类 provider 时,需准备好对应密钥
- Docker 部署需 amd64 或 arm64 架构,并已安装 Docker
安装与启动步骤
-
1安装 CLI
全局安装 agency-orchestrator,装好后终端可用 ao 命令。若只用桌面客户端则无需安装,桌面端自带引擎与 Node,双击即用。
npm install -g agency-orchestrator -
2启动网页 Studio
本地跑一条 ao web,即可在浏览器里勾选专家、运行工作流、查看产物并实时介入,全中英双语界面。
ao web -
3运行内置工作流
用内置的「一人公司全员大会」模板跑第一轮,通过 -i 传入 idea 变量。工作流文件位于仓库 workflows 目录下。
ao run workflows/一人公司全员大会.yaml -i idea="用AI帮小商家做短视频" -
4让整队人接新活
用 --team 指定已保存的团队,AO 会把可选角色锁定为该团队成员并重新设计步骤后运行,不漏人也不幻觉出别的角色。
ao run --team 技术博客组 "写一篇关于 RISC-V 架构的科普" -
5查看团队信息
team list 列出已保存的团队,team show 查看某个团队的阵容构成。团队以纯 YAML 存在 ~/.ao/teams 下,可与 Studio 共用。
ao team list ao team show 技术博客组 -
6Docker 部署
适合 Docker / NAS 场景,映射 8088 端口并挂载数据卷,密钥在页面「供应商」里配置,存进挂载卷后重启不丢。
docker run -d -p 8088:8088 -v ao-data:/data ghcr.io/jnmetacode/agency-orchestrator:latest
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
AO_HOME | 否 | 统一工作区目录,产物与生成的工作流都落到这里,不再随执行目录散落 | ~/.ao |
AO_DATA_DIR | 否 | 指定产物 / 数据目录 | /your/path/ao-data |
AO_AGENTS_DIR | 否 | 指定私有专家角色库目录,run / compose / roles / web 全部改用该库 | /你的角色目录 |
AO_OUTPUT_DIR | 否 | 单独指定运行产物输出目录 | /your/path/ao-output |
AO_WORKFLOWS_DIR | 否 | 单独指定工作流目录 | /your/path/workflows |
如何确认成功
Docker 方式打开 http://主机IP:8088 能看到 Studio 页面;本地执行 ao web 后能在浏览器中勾选专家并运行工作流。
常见问题
Q:没有 API 密钥可以用吗?
A:可以。AO 支持 11 种免 key 方式,本机已登录 Claude Code / Gemini CLI 等会被自动探测并直接使用,零配置首跑,无需配置任何密钥。
Q:该装 CLI 还是用桌面客户端?
A:桌面客户端自带引擎与 Node,双击即用,无需 npm 安装;只有想在终端用 ao 命令或接进脚本 / CI 时才需要安装 CLI。
Q:团队配置存在哪里,能和网页版共用吗?
A:团队存在 ~/.ao/teams/*.team.yaml,是纯 YAML 可直接拷贝分享,命令行和网页 Studio 共用同一份,两边操作互相可见。
Q:怎么用自建的专家角色?
A:单个角色放到 ~/.ao/roles/<id>.md 与内置库叠加,工作流里用 my/<id> 引用;也可设 AO_AGENTS_DIR 指定整个私有角色库。
注意事项
- 选择 --provider claude-code(或 gemini-cli / codex-cli)时必须本机已安装并登录对应 CLI,否则请改用 API key 类 provider。
- 不设 AO_HOME 时运行产物会写到当前目录,建议先固定全局目录以免文件散落。
- Docker 部署的密钥在页面「供应商」中配置,会存进挂载卷,重启不会丢失。
- README 未给出 ao web 的默认端口,本地访问地址以启动后终端提示为准。
核心亮点
- 零代码 YAML 配置,非程序员也能编排多智能体协作流程
- 内置自动验收机制,自动检查输出质量,减少人工审核成本
- 支持 11 家 LLM 提供商且 7 家免密钥,开箱即用,灵活切换模型
不足之处
- 项目处于成长阶段,文档和生态可能尚不完善
- 多智能体协作的复杂场景下,YAML 配置可能变得冗长难维护
适用场景
- 快速生成市场分析报告或商业计划书
- 自动化处理多步骤内容创作(如撰写+校对+排版)
- 为小型团队搭建定制化 AI 工作流,无需编写代码
替代项目
CrewAI、AutoGen、LangGraph
上一篇:codesearch
下一篇:zenith
同类项目推荐
JobMatch-AI
开源
上传简历,AI 秒筛匹配职位,附优化建议
AI-powered job matching agent using CoreSpeed's Zypher framework. Analyzes JD-resume···
cayu
开源
让长任务智能体崩溃后能接着跑,不丢进度
Cayu is an open-source Python framework for building and running domain-specific lon···
Themata-Claude-Scribe
开源
用 Claude 子智能体搭互动故事引擎,长篇剧情不崩人设
Claude Mythos Engine 2026: AI Sub-Agent Framework for Epic Interactive Storytelling
emilia-protocol
开源
给AI智能体装道门禁,动钱动权限前先验明正身
Authority control plane for autonomous work. EMILIA Gate enforces finite customer-ow···
claude-banana
开源
把模糊想法变成专业图像提示词,让 AI 画得更准
AI agent that turns your rough ideas into perfect image generation prompts. 7-compon···
memor
开源
让LLM记住关键信息,告别对话失忆
Reproducible Structured Memory for LLMs
deterministic-agent-control-prot···
开源
给AI智能体装上安全阀门,操作可控可审计
Governance gateway for AI agents — bounded, auditable, session-aware control with M···
open-instinct
开源
在 iMessage 里发条消息,AI 助手在自己电脑上帮你干活
Open Instinct: an open-source Instinct. A personal agent you text on iMessage, with ···
logic-pro-mcp
开源
让 AI 安全操控 Logic Pro,实时读写工程状态
Local MCP server for stateful, fail-closed Logic Pro control and live project readba···
