Self Host · Cloud · Docs

Recombyn is a canvas editor + AI Design Agent (source-available).
Design on an infinite canvas; a LangGraph agent edits layers, shapes, text, and layout through conversation.

Self-host in minutes with Docker Compose (default MySQL + Redis + web + API + Yjs collab). Local dev can use SQLite (empty DATABASE_URL), or PostgreSQL — see docs/postgres-switch.md.

• Real canvas editing — Frames, shapes, images, video, text; export and share
• Live multiplayer — Yjs sync for the same project (cursors, selection, undo); share view-only or edit
• Agent that paints — Conversation plans and applies canvas ops
• Self-host first — Same stack locally or on a server
• Composable — Infra seeds + prompt packs + 5 core Agent skills under apps/api/data/public/

• Visual editor — selection, layers, fills, export, share
• Realtime collab — Yjs WebSocket room (apps/collab); Live bar in the editor; WSS via nginx /collab/
• Design Agent — LangGraph tools / skills; create, edit, and chat with streaming UI
• Image import — local images → editable canvas nodes
• Plaza & projects — inspiration feed and saved work (API)

git clone https://github.com/recombyn/recombine.git
cd recombine
cp apps/api/.env.example apps/api/.env   # add LLM_API_KEY / provider keys
docker compose up -d --build

More options (env, LLM keys, production hardening): docs/self-hosting.md · Postgres: docs/postgres-switch.md

docker compose up -d redis   # or: mysql redis
npm install
cp apps/api/.env.example apps/api/.env
npm run dev:api              # empty DATABASE_URL → SQLite
npm run dev:collab           # Yjs WS on :1234 (optional; Vite DEV defaults collab on)
npm run dev:web

Canvas Live / WSS setup: docs/self-hosting.md § Canvas multiplayer · apps/collab/README.md

apps/web/          React canvas + Agent UI + Yjs client
apps/api/          FastAPI — Scene, Agent, plaza, wallet, collab tokens
apps/collab/       Yjs WebSocket server (y-websocket)
apps/docs/         Help / legal site
packages/          Shared builders & schemas
docs/              Architecture + self-hosting
deploy/            Dockerfiles / Nginx
e2e/               Playwright

• Issues — bug & feature templates under .github/ISSUE_TEMPLATE/
• PRs — see CONTRIBUTING.md
• Security — report privately per SECURITY.md

Recombyn Source Available License v1.0 © Recombyn contributors · NOTICE

Source-available terms (not OSI open source):

• Personal / private self-host — free
• Internal org use — permitted
• Hosted / managed service of Recombyn to third parties (paid or free) — requires commercial authorization ([email protected])

See LICENSE for the full text.

Open source takes time. If Recombyn helps your work, please hit ⭐ Star in the top-right of the GitHub repo — your support is the best fuel for making it better.

→ https://github.com/recombyn/recombyn