Skip to main content

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
TerminalCommand
Backendmyrm start or ./scripts/dev/run_server.sh --webui
Frontendcd 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)
./myrm start            # backend + frontend

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.

Code quality

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