# mosoo

**Repository Path**: dify_ai/mosoo

## Basic Information

- **Project Name**: mosoo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-02
- **Last Updated**: 2026-07-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mosoo

## Product Status

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](./docs/SPEC.md) and [App Boundary](./docs/prd/app-boundary.md) 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](./docs/prd/README.md).
- Current product spec: [SPEC.md](./docs/SPEC.md).
- Architecture design: [docs/architecture.md](./docs/architecture.md).
- Development and contribution guide: [CONTRIBUTING.md](./CONTRIBUTING.md).

## Local Development

See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full development flow.

Prerequisites:

- `bun >= 1.4.0-canary.1`
- `just >= 1.51`
- Agent runtime / sandbox flows also need Docker Desktop; see the contribution guide before validating those paths.

From a clean clone:

```bash
git clone --recurse-submodules https://github.com/langgenius/mosoo.git
cd mosoo
just setup
just dev
```

`just 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:

```bash
curl http://localhost:5173/api/health
curl http://localhost:8787/api/health
```

API 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](./CONTRIBUTING.md).