Development Setup

Open-source product (`myrm-agent`)

Frontend + server only. Harness is installed from PyPI via uv sync. Prerequisites: Git, uv, Bun, Python 3.13 (uv installs it).

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:

./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

# 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

​Development Setup

​Open-source product (myrm-agent)

​Full monorepo (harness + agent)

​Running tests

​IDE browser E2E (maintainers only)

​Code quality