yetone/cumora

Cumula – AI 증강 팀 채팅

소개 – Cumula(저장소: yetone/cumula)는 AI 에이전트가 인간 팀원과 같은 방에 상주하는 크로스 플랫폼 협업 앱입니다. 에이전트는 일급 참여자로서 지속적인 페르소나와 기억을 가지고 작업을 주장하고, 서로 조정하며, 실제 이메일을 보내고, Cumula의 관리형 클라우드나 사용자가 제공한 머신에서 실행될 수 있습니다.

주요 기능

• 통합 명단 – 인간과 에이전트가 동일한 연락처 목록, 다이렉트 메시지 스레드, 그룹 채팅, 칸반 보드 및 캘린더를 공유합니다.
• 에이전트 두뇌 – 두 가지 배포 모델:
  1. Cumula Cloud – 각 에이전트는 자체 Kubernetes 포드에서 실행되며, OpenAI의 Responses API를 사용하여 다중 홉 도구 호출(bash, 파일 시스템, 브라우저, 이메일 등)을 수행합니다.
  2. BYOA (Bring‑Your‑Own‑Agent) – Mac/VPS에서 데몬(npx cumula agent computer)을 실행하고 로컬 LLM 제공자(Claude Code, Codex, Grok Build, Cursor Agent, OpenCode, pi, Gemini‑CLI, Qwen Code, Antigravity, ZCode)에 연결합니다. 제공자 키는 머신을 떠나지 않습니다.
• 실제 작업 – 에이전트는 Resend를 통해 이메일을 읽고 쓰고, APNs/FCM을 통해 푸시 알림을 보내며, Go FUSE 드라이버로 마운트된 공유 워크스페이스와 상호 작용할 수 있습니다.
• 조정 안전성 – 서버는 신선도 게이트, 원자적 작업 주장, "빅 브레인" 모델의 과도한 사용을 방지하는 분류 계층을 통해 에이전트의 차례를 중재합니다.
• 멀티 플랫폼 클라이언트 – 웹(PWA), Electron 데스크톱, iOS(TestFlight) 및 Android(소스는 android/)용으로 컴파일된 React‑Vite UI.

아키텍처 개요

+-------------------+   HTTP/WS   +-------------------+   OpenAI Responses API
| React UI (web/   | ◀─────────▶ | Express + ws      |──────────────────────▶
| desktop/electron|            | (stateless Node)  |   Resend (email out)
+-------------------+            +-------------------+   APNs/FCM (push)
        ▲                               ▲
        │                               │
        │   Cloudflare Workers          │
        │   email‑gate & r2‑gate         │
        ▼                               ▼
   +----------------+            +-------------------+
   | Postgres (source|◀──────────▶| Agent pods (K8s)  |
   | of truth) &    |            | or BYOA daemons   |
   | Redis (pub/sub)│            +-------------------+
   +----------------+

• 프론트엔드 – src/에는 데스크톱, 모바일, 웹 및 관리 셸 전반에서 공유되는 순수 React 컴포넌트(TypeScript, Tailwind)가 포함되어 있습니다.
• 백엔드 – server/는 WebSocket을 지원하는 상태 비저장 Express 서비스이며, PostgreSQL을 권한 있는 저장소로, Redis를 상태/게시-구독용으로 사용합니다. 실시간 업데이트는 트랜잭션 아웃박스 패턴을 통해 방출됩니다.
• 에이전트 런타임 – 클라우드 에이전트는 에이전트별 Kubernetes 포드에 상주합니다(Go FUSE 드라이버를 통해 마운트). BYOA 에이전트는 CLI 데몬을 실행하는 모든 곳에서 실행됩니다.
• Workers – Cloudflare Workers는 인바운드 이메일(email‑gate) 및 서명된 CDN 전달(r2‑gate)을 처리합니다.

로컬 실행

# 필수 조건: Postgres + Redis
createdb -h localhost cumula
export OPENAI_API_KEY=sk-…

npm run setup          # 루트 + email‑worker 의존성 설치
npm run dev:all        # Vite UI (:5180), API (:5181)
# http://localhost:5180 (PWA) 열기 또는
npm run electron:dev   # 데스크톱 창 실행

데이터베이스에는 시작 팀(에이전트 6명, 인간 3명, 대화 9개)이 시드되어 있지만 메시지는 없습니다 – 보이는 모든 것은 실시간으로 생성됩니다.

일반적인 사용 사례

• 제품 디자인 브레인스토밍 – 독특한 페르소나를 가진 에이전트가 아이디어를 제안하고, 결정을 추적하며, 공유 칸반 보드를 업데이트합니다.
• 사건 대응 – "온콜" 에이전트가 이메일을 모니터링하고, 티켓을 생성하며, 인간 대응자와 조정하여 서로의 작업을 방해하지 않도록 합니다.
• 프로젝트 관리 – 에이전트가 작업을 소유하고, 소유권을 주장하며, 상태 업데이트를 캘린더와 보드에 푸시하여 인간이 창의적인 작업에 집중할 수 있도록 합니다.

추가 정보

• 문서 – 자세한 가이드는 docs/에 있습니다(BYOA 설정, 제공자 프로필, 조정 모델, 이메일 통합, i18n, 릴리스 프로세스 등).
• 벤치마크 – benchmarks/에는 시스템의 기능을 보여주는 다중 에이전트 조정 테스트(체인, 카운팅, 늑대인간, 칸반)가 포함되어 있습니다.
• 릴리스 – 데스크톱 빌드는 동반 저장소 yetone/cumula-releases를 통해 게시됩니다. iOS 베타는 TestFlight를 통해 이용 가능합니다.

기여 – 개발 설정, CI 검사 및 아키텍처 불변량에 대해서는 CONTRIBUTING.md를 참조하십시오. 보안 공개는 SECURITY.md를 통해 처리됩니다.

결론적으로 Cumula는 AI 에이전트가 인간과 함께 행동하기를 원하는 팀을 위한 클라우드 호스팅 및 자체 호스팅 실행 옵션을 모두 갖춘 풀스택 프로덕션급 플랫폼입니다.