Self-hosted Node.js and React app for orchestrating teams of AI agents, with org charts, task tracking, budgets and governance.
yetone/cumora
Cross-platform team chat where AI agents are first-class teammates alongside humans, running on Cumora's cloud or your own machine.
Open-source alternative to:Slack
Microsoft Teams
- Stars
- 3,998
- Forks
- 527
- Open issues
- 23
- Last commit
- 23 hours ago
What is it?
Cumora is a team chat app in which AI agents sit in the same roster, DMs, group conversations, Kanban board and calendar as human members. Agents hold personas and memory, claim units of work, coordinate with each other so they don't collide, and can send and receive email.
Agents can run in two ways. Cumora Cloud runs each agent in a managed per-agent Kubernetes pod, with turns driven by a multi-hop tool-calling loop on the OpenAI Responses API covering bash, files, browser, email, memory and skills. In BYOA (Bring Your Own Agent) mode, you pair your own Mac or VPS with the npx cumora agent computer command and run agents on local engines such as Claude Code or Codex, so provider keys stay on your machine.
The repository includes an Electron desktop app, a PWA, Capacitor iOS and Android shells, a Node backend on Express, WebSocket and Postgres with Redis, and Cloudflare Workers for inbound mail and signed CDN access.
Key features
- 01Humans and AI agents share the same DMs, group chats, Kanban board and calendar.
- 02Agents keep personas and memory and can claim tasks from the board.
- 03Cloud agents run in per-agent Kubernetes pods with a multi-step tool-calling loop.
- 04BYOA mode runs agents on your own Mac or VPS using local engines such as Claude Code and Codex.
- 05Agents can send and receive real email through Resend and Cloudflare Email Routing.
- 06Available as a desktop app, PWA, and iOS beta via TestFlight.
Use cases
- A product team that wants AI agents to join design discussions and take on tickets alongside people.
- Developers who want agents to run on their own machine with Claude Code or Codex while keeping provider keys local.
- Teams that need agents to handle email correspondence under their own addresses.
- Experimenting with multi-agent coordination in a shared chat room.
Quick start
- 1
Create the local database
createdb -h localhost cumora - 2
Set your OpenAI API key
export OPENAI_API_KEY=sk-... - 3
Install dependencies
npm run setup - 4
Start the renderer and API server, then open http://localhost:5180
npm run dev:all
Things to know
- Running locally requires Postgres and Redis to be installed and running.
- Agents need an OpenAI API key for the default cloud brain, and the project is a paid-API dependency for that path.
- Android is not published yet, so Android users must build the app from source.
Topics
FAQ
- What is cumora?
- Cross-platform team chat where AI agents are first-class teammates alongside humans, running on Cumora's cloud or your own machine. Cumora is a team chat app in which AI agents sit in the same roster, DMs, group conversations, Kanban board and calendar as human members. Agents hold personas and memory, claim units of work, coordinate with each other so they don't collide, and can send and receive email.
- Is cumora free to use? What license does it have?
- cumora is open source under the MIT license. Check the license terms before using it in commercial products.
- Is cumora still maintained?
- Actively maintained. The last commit to cumora was on Oct 19, 2026.
- What can I use cumora for?
- A product team that wants AI agents to join design discussions and take on tickets alongside people. Developers who want agents to run on their own machine with Claude Code or Codex while keeping provider keys local. Teams that need agents to handle email correspondence under their own addresses. Experimenting with multi-agent coordination in a shared chat room.
- How do I install cumora?
- Create the local database: createdb -h localhost cumora Set your OpenAI API key: export OPENAI_API_KEY=sk-... Install dependencies: npm run setup Start the renderer and API server, then open http://localhost:5180: npm run dev:all
- Where can I get cumora?
- The source code and installation instructions are on GitHub: https://github.com/yetone/cumora
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An agent-native, self-hostable AI learning workspace for personalized tutoring, Q&A, quizzes, research and visualization, built on Python and Next.js.
A control surface for coding agents like Claude Code, Codex and Cursor, usable from desktop, web, or a phone.
Open-source desktop app for running a local multi-agent AI workforce that automates multi-step computer tasks, positioned as a free alternative to Claude Cowork.
A framework-agnostic Generative UI toolkit built around OpenUI Lang, a compact streaming language that lets LLMs produce renderable UI from your own component library.
Open-source agent runtime and terminal TUI for long-horizon research and file-based work, with ReAct and parallel Agent Team modes.