> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Development Setup

> Set up your development environment for Myrm (OSS product + harness monorepo).

# Development Setup

## Open-source product (`myrm-agent`)

Frontend + server only. Harness is installed from PyPI via `uv sync`.

**Prerequisites:** Git, [uv](https://docs.astral.sh/uv/), [Bun](https://bun.sh), Python 3.13 (uv installs it).

```bash theme={null}
git clone https://github.com/Pursue-LLL/myrm-agent.git
cd myrm-agent
myrm setup
```

| Terminal | Command                                               |
| -------- | ----------------------------------------------------- |
| Backend  | `myrm start` or `./scripts/dev/run_server.sh --webui` |
| Frontend | `cd myrm-agent-frontend && bun run dev`               |

Use `.venv/bin/python run.py` (or `myrm start`) instead of `uv run run.py` after editable harness installs in a monorepo — `uv run` can re-resolve locks and fail on macOS when Windows-only wheels are in the lockfile.

## Full monorepo (harness + agent)

For harness framework work, clone the **vortexai** monorepo (private) with `myrm-agent` and `myrm-agent-harness` siblings, then:

```bash theme={null}
./myrm setup            # editable harness into server venv (vortexai root)
git pull && ./myrm ready  # harness self-heal + :8080/:3000 (same path as ./myrm start)
./myrm test -n0 <paths>   # all pytest via gate; do not use uv run pytest in monorepo
```

For MCP UI checks on real logged-in Chrome: `./myrm ready --chrome` (see `MAINTAINER_QUICKSTART.md`).

## Running tests

```bash theme={null}
# Frontend (myrm-agent-frontend)
bun test

# Server (myrm-agent-server)
cd myrm-agent-server
.venv/bin/python -m pytest
```

Harness unit tests run inside `myrm-agent-harness` when you have that repository checked out.

## IDE browser E2E (maintainers only)

Cursor / chrome-devtools-mcp setup, `:3000` slowness, and monorepo dev gates are **not** end-user product docs. See the private monorepo **`scripts/dev/MAINTAINER_QUICKSTART.md`** (vortexai root).

## Code quality

* Frontend: ESLint + Prettier
* Backend: Ruff + strict typing in server and harness packages