Self-hosting

Mushi is OSS-first. Mushi Cloud at kensaur.us/mushi-mushi/admin runs the exact same code in this repo — there is no closed-source plus-tier. Every edge function, migration, and admin SPA you see here is the same binary that powers Mushi Cloud.

Prerequisite: Node ≥ 22, a Supabase project, and the Supabase CLI .

What you’ll deploy

Layer	Technology	License
Database + Auth	Supabase (Postgres 15 + pgvector + pgcrypto + pg_cron)	Open
Edge Functions	14 Hono functions on Supabase Edge (Deno)	AGPLv3
Admin SPA	React + Vite, deployed to any static host	AGPLv3
Observability	Langfuse + Sentry	MIT / Commercial
Sandbox	E2B managed (or self-hosted Modal)	External

Fastest path — Docker Compose

The whole stack (Postgres + Auth + REST + Storage + edge functions + console) in one command, no managed Supabase project required:


git clone https://github.com/kensaurus/mushi-mushi.git
cd mushi-mushi/deploy
cp .env.example .env   # set ANTHROPIC_API_KEY + Supabase creds
docker compose up -d

See Self-host in minutes for the full walkthrough.

Managed-Supabase path

Prefer a hosted Supabase project? Link it and push the schema:


git clone https://github.com/kensaurus/mushi-mushi.git
cd mushi-mushi
npm install                                        # installs all workspaces
cd packages/server                                 # Supabase CLI works relative to this dir
npx supabase link --project-ref <your-ref>
npx supabase db push                               # applies all migrations

Then follow the guides in order:

Supabase setup — extensions, RLS, and required seed data
Edge Functions deploy — all 15 functions + secrets
Admin SPA deploy — build and deploy the console
Observability (Langfuse + Sentry) — traces and error tracking