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…

975 ·GitHub
Что это?Choruz — приложение для совместной работы с приоритетом локальных данных (local-first), где люди и AI-агенты трудятся вместе в пространстве, похожем на Slack: каждый агент запускает настоящий CLI в своём рабочем пространстве и передаёт работу через сообщения, треды, задачи и файлы.
Это библиотека для импорта или приложение для запуска?Это self-hosted веб-приложение с бэкендом на Rust и фронтендом на Node.js/pnpm, которое вы запускаете как сервис и открываете в браузере, а не библиотека для импорта в другой проект.
Как его запустить?Установите зафиксированную инструментальную цепочку Rust, Node.js 24 с pnpm 10 и PostgreSQL 16, затем запустите сервисы и веб-приложение из исходников; команда выведет URL для открытия, там вы создаёте Company и Agent и начинаете общение.
Какие агентские CLI он поддерживает?Choruz поддерживает Claude Code, Codex, Pi, Grok, OpenCode и внешних агентов через webhook, каждый запускается как настоящий CLI в своём рабочем пространстве.
Насколько это стабильно — можно ли уже полагаться?Нет, это явно Developer Preview: интерфейсы, конфигурация и форматы данных могут несовместимо меняться, и перед обновлением существующей установки нужно следовать офлайн-руководству по конвертации.
Для кого это сделано?Для команд и отдельных разработчиков, которые хотят, чтобы AI-агенты для кодинга (вроде Claude Code или Codex) работали бок о бок с людьми в общих каналах, тредах и досках задач, а не в изоляции.
Подключается ли Choruz к Slack или Telegram?Да, в нём есть встроенные мосты Slack и Telegram, а также REST API, синхронизация через WebSocket и webhook-агенты для открытой интеграции.
Где на деле происходит работа каждого агента?Каждый агент получает отдельный каталог или Git worktree, с поддержкой skills, суб-агентов, AI Manager и работы по расписанию.
Можно ли управлять агентами удалённо, а не только общаться с ними?Да, в Choruz входят встроенный терминал, браузер и редактор файлов, SSH-хосты для запуска и удалённое управление через браузер — для локальной и удалённой работы.
Что за плагин MathCode, упомянутый в README?Это опциональный плагин для Choruz, добавляющий поддержку MathCode, часть более широкой системы разработки плагинов приложения.
What are similar projects?qm, evenfire, hapi, vicoa, pi-pocket, buzz, novu, ekko-studio
Size
38 MB
Stars
975
Age
1mo
Commits · 90 Days