Skip to content

talesofai/cohub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,511 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cohub

Your own space to create, play, and build with people and agents.

Cohub is a living Space for people and agents. Start anywhere, make in any medium, share as Works.

It combines:

  • a browser-first Space for conversation, files, sessions, tasks, and previews
  • checkpoint-based saving, forking, and remixing
  • multimodal generation for text, image, video, and music
  • public Spaces and Works for discovery and sharing
  • CLI and external channels for people and agents to act from anywhere

Core Ideas

Fun to start

Open a Space and play with ideas, prompts, files, and agents.

Build together

People and agents in one context. Co-create, save, and share.

Open everywhere

Web, mobile, CLI, Discord, WeChat. The Space follows you.

Powerful for real work

Games, apps, media, automations, custom homes — from playful to production.

Never start blank

Fork a checkpoint into a new Space, or reference any Space with @space as context.

Core Concepts

Space

A Space is the main creative surface in Cohub.

It is a live, isolated environment where people and agents work together. A Space holds conversations, files, drafts, outputs, and experiments in one place.

Checkpoint

A Checkpoint is an immutable snapshot saved from a Space.

It preserves a meaningful moment, and can be shared, forked, restored, or used as a stable base for new work.

Proposal

A Proposal is a collaboration flow for bringing work from one checkpoint back into another Space.

It keeps review, discussion, and integration close to the work itself.

Agent

An Agent is the active collaborator operating inside a Space.

Session

A Session is a conversation context inside a Space. Each Session keeps its own history and can evolve independently.

Channel

A Channel is an external entry point connected to a Space.

Examples include Web, Discord, Telegram, Feishu, and WeChat. People can talk from those channels, and agents can respond back through them.

Sandbox

A Sandbox is the execution environment behind a Space.

It provides runtime capabilities while staying behind the product surface.

Product Shape

Cohub is built around one idea: people create in Spaces, and useful context gets saved as Checkpoints.

The platform is for:

  • creating with people and agents in live Spaces
  • saving milestones as Checkpoints
  • forking from Checkpoints into new Spaces
  • proposing changes back into another Space
  • publishing Works from files, directories, or ports
  • using CLI and APIs to automate the same product surface

Cohub is a shared creative space for people and agents to create, save, share, and build from real context.

Repository Structure

cohub/
├── apps/
│   ├── api/          # Hono API — orchestration, provisioning, session persistence
│   ├── agent/        # Agent control service — Pi coding agent, WS client connecting to sandbox
│   ├── sandbox/      # Sandbox executor — Go WS server for workspace / fs / process
│   ├── gateway/      # External channel gateway (Discord, Telegram, Feishu, WeChat, etc.)
│   ├── web/          # SvelteKit web app
│   └── worker/       # Task scheduler — cron jobs and async task processing
├── deploy/           # Deployment configs (per environment)
├── docs/             # Architecture and product model docs
├── packages/
│   ├── protocol/     # Shared types and protocols across apps
│   └── sdk/          # Client SDK for Spaces, Sessions, Checkpoints, and more
├── scripts/          # Utility scripts
└── README.md

Tech Stack

  • Language: TypeScript + Go
  • Frontend: SvelteKit
  • Backend: Hono
  • Agent Runtime: pi-coding-agent (WS client, connects to sandbox)
  • Sandbox Runtime: Go + WebSocket server
  • Database: PostgreSQL + Drizzle ORM
  • Infrastructure: Kubernetes (ACK)
  • Package Manager: pnpm monorepo

Development

pnpm install
pnpm dev

Quality Checks

pnpm lint
pnpm typecheck
pnpm build

Docs

Recommended starting points:

  • docs/CO-CREATION-MODEL.md
  • docs/space-state-model.md
  • docs/generations.md
  • docs/works-guide.md
  • docs/agent-sandbox-runtime.md
  • docs/prod-deploy-checklist.md

Open Source Notes

  • License: Apache License 2.0 (Viscept Limited)
  • Billing is disabled by default; configure TALESOFAI_BILLING_* to enable the hosted billing provider
  • OpenTelemetry remote export is opt-in via OTEL_EXPORTER_OTLP_*
  • Copy deploy/**/values.example.yaml to local values.yaml for deploys
  • Self-hosting guide: docs/self-hosting.md
  • Security reports: SECURITY.md or dev@talesof.ai

License

Apache License 2.0 © Viscept Limited

About

Your own space to create, play, and build with people and agents.

Topics

Resources

License

Contributing

Security policy

Stars

5 stars

Watchers

2 watching

Forks

Packages

 
 
 

Contributors