Mosoo is still in alpha exploration. Product boundaries, data models, deployment methods, and management experience are all evolving quickly. During the App boundary cut, treat SPEC.md and App Boundary as newer than older Agent-first, Workspace, member-management, or team-governance language. This repository currently prioritizes fast validation and architectural convergence for the open-source version, with no promise of stable APIs or backward compatibility.
- PRDs and product design: docs/prd/README.md.
- Current product spec: SPEC.md.
- Architecture design: docs/architecture.md.
- Development and contribution guide: CONTRIBUTING.md.
See CONTRIBUTING.md for the full development flow.
Prerequisites:
bun >= 1.4.0-canary.1just >= 1.51- Agent runtime / sandbox flows also need Docker Desktop; see the contribution guide before validating those paths.
From a clean clone:
git clone --recurse-submodules https://github.com/langgenius/mosoo.git
cd mosoo
just setup
just devjust setup installs dependencies, initializes submodules, creates or completes apps/api/.dev.vars, installs Git hooks, and applies the local D1 baseline. just dev reapplies the local D1 migration before starting the web and API dev servers.
Local URLs:
- Web:
http://localhost:5173 - API:
http://localhost:8787
The public landing page and blog live in the private langgenius/mosoo-website repository and are deployed on mosoo.ai.
Minimum smoke:
curl http://localhost:5173/api/health
curl http://localhost:8787/api/healthAPI health is /api/health, not /health. Regular email login uses OTP; under local loopback origins, addresses ending with @mosoo.ai skip OTP and log in directly.
If setup fails, start with the focused recipe: submodule issues use git submodule update --init, missing local secrets use just env-init, and D1 schema errors use just db-migrate. For details and verification expectations, read CONTRIBUTING.md.