Choruz README

The project's README from github.com/inclusionAI/Choruz. As one markdown file: README.md.

Choruz

Choruz — A Collaboration Space for Humans and AI Agents

Choruz is a local-first collaboration app where humans and AI agents work together in a Slack-like space. Each agent runs a real CLI in its own workspace and can hand work to people or other agents through messages, threads, tasks, and files.

Choruz supports Claude Code, Codex, Pi, Grok, OpenCode, and webhook-driven external agents. An optional plugin enables MathCode.

Demo

https://github.com/user-attachments/assets/4b82c980-0083-4294-b947-dff9a3a59078

Developer Preview

Choruz is under pre-release development. Its interfaces, configuration, and data formats may change incompatibly. Before upgrading an existing installation, follow the offline conversion guide.

Run

Requirements

Run from source

git clone https://github.com/jcguo123/Choruz.git
cd Choruz
pnpm install
pnpm dev:all

Start the Web app in another terminal:

pnpm dev:web

The command prints the URL to open. The main checkout uses http://127.0.0.1:3100 by default, while Git worktrees receive independent ports automatically. In the Dashboard, create a Company and an Agent, then start a direct chat or mention the Agent in a group.

Stop the Web app and Choruz services:

pnpm stop:all

Core Capabilities

Documentation

After starting the Web app, open /docs for the user guide. Its source is under apps/web/app/docs. Continue with these engineering and integration references:

Contributors

Jiacheng Guo (@jcguo123) Yunlong Gao (@DPLL) Suozhi Huang (@hsz0403) Jason Ge (@jasonge27)

Contributors appear in the order defined in CONTRIBUTORS.md.

License

Source code and software documentation are licensed under the MIT License. Visual assets have separate provenance and license records in assets/THIRD_PARTY.md and assets/brand/README.md. The MIT License does not grant rights to the Choruz name or product identity.

Choruz (inclusionAI/Choruz)

Searching Database…

957 ·GitHub
这是什么?Choruz 是一款本地优先的协作应用,人类和 AI 代理在一个类 Slack 的空间里协同工作,每个代理在自己的工作区里运行真实的 CLI,并通过消息、话题、任务和文件交接工作。
这是我导入的库,还是我运行的应用?它是一个自托管的 Web 应用,后端用 Rust、前端用 Node.js/pnpm,你把它作为服务运行并在浏览器中打开,而不是导入到其他项目里的库。
怎么让它跑起来?安装项目固定的 Rust 工具链、Node.js 24(含 pnpm 10)和 PostgreSQL 16,然后从源码启动各个服务和 Web 应用;命令会打印出要打开的 URL,在那里创建一个 Company 和一个 Agent,就可以开始聊天了。
它支持哪些代理 CLI?Choruz 支持 Claude Code、Codex、Pi、Grok、OpenCode,以及由 webhook 驱动的外部代理,每个代理都在自己的工作区里作为真实 CLI 运行。
它现在稳定到可以依赖的程度了吗?没有,它明确是一个开发者预览版:接口、配置和数据格式可能出现不兼容的变动,升级现有安装之前需要按照离线转换指南操作。
这是为谁打造的?适合团队和个人开发者,他们希望 AI 编程代理(如 Claude Code 或 Codex)在共享的频道、话题和任务板中与人类并肩协作,而不是孤立地运行。
Choruz 能连接 Slack 或 Telegram 吗?可以,它内置了 Slack 和 Telegram 桥接,此外还有 REST API、WebSocket 同步和 webhook 代理,方便开放集成。
每个代理的工作实际发生在哪里?每个代理都有一个专属目录或 Git worktree,支持技能、子代理、AI 管理器和定时任务。
我可以远程控制代理,而不只是和它们聊天吗?可以,Choruz 内置了集成终端、文件浏览器和编辑器、SSH 运行时主机,以及基于浏览器的远程控制,支持本地和远程操作。
README 里提到的 MathCode 插件是什么?它是 Choruz 的一个可选插件,增加了 MathCode 支持,属于该应用更大的插件开发体系的一部分。
What are similar projects?qm, evenfire, hapi, vicoa, pi-pocket, buzz, novu, ekko-studio
Size
38 MB
Stars
957
Age
1mo
Commits · 90 Days