Skip to content
Docs menu

make targets

What each make target in a venom checkout does, for running the dev stack, building and testing.

View .md

A venom source checkout is driven by make. make alone opens the devbox shell with the pinned toolchain; make help lists every target with its one-line description. Variables go after the target: make up SERVICES="orchestrator ollama", make cli ARGS="-p hi".

make env                       # .env from .env.example
make up                        # orchestrator + console in docker
make cli ARGS="doctor"         # venom against that orchestrator
make test                      # every suite: the no-regression gate
make down                      # stop everything this checkout started

Run the stack

Target What it does
make shell Enter the devbox shell (the default target).
make help List the targets.
make env Create .env from .env.example if missing.
make up Run make down, then start SERVICES in docker (default: orchestrator and console; ORCH_TARGET/WEB_TARGET=prod for the production images). Uses a native Ollama when one runs and starts llmfit serve when installed.
make up-mac macOS: orchestrator and console in docker, Ollama native on the host for the GPU. Fails if Ollama is not up.
make down Stop every docker service (all profiles) and this checkout's host-side orchestrator, console, mock, venom serve and llmfit serve. Volumes are kept.
make restart Restart SERVICES.
make ps Show running services.
make logs Tail logs for SERVICES.
make build Build the docker images for SERVICES.
make pull-model Pull one Ollama model (MODEL=qwen3:8b) into the native Ollama if one runs, else the compose one.
make pull-models Pull the models the default routes use (VENOM_OLLAMA_MODEL, VENOM_OLLAMA_FAST_MODEL).
make model Choose, set up and route the local model: a menu, or BACKEND=ollama|vllm MODEL=<tag or repo>.
make model-status The local model .env selects, what runs, and GPU memory.
make dev-orchestrator The orchestrator on the host with hot reload.
make dev-web The console on the host (next dev, port 3000).
make dev-cli Rebuild the CLI on change.
make mock A fixture orchestrator on port 8787 for console work.
make cli Run venom against the local orchestrator (ARGS="..."; VENOM_CLI_FLAGS in .env adds flags to every run).
make serve venom serve (needs VENOM_SERVER_TOKEN; ARGS="--root ~/work").
make link-cli Put venom on your PATH: a link to the built CLI in npm's global bin dir.
make install Install every JavaScript dependency with bun, from each package's bun.lock (Go modules are fetched on build).
make clean Remove build output.

Build

Target Output
make build-orchestrator The orchestrator binary in services/go-orchestrator/bin/.
make build-web A production build of the console.
make build-harness The harness library in packages/harness/dist/.
make build-server The harness server in packages/harness-server/dist/.
make build-acp The ACP agent in packages/acp/dist/.
make build-cli The CLI in cli/dist/.
make build-python-client The venom-client sdist and wheel in clients/python/dist/.

Test and check

Target What it runs
make test Every suite below that needs no network or model: the gate before any pull request.
make test-orchestrator Go tests with the race detector.
make test-harness Harness type check and unit tests (permissions, compatibility, subagents).
make test-server Harness server type check, unit and integration tests with a fake model.
make test-acp ACP agent tests with a scripted ACP client over stdio.
make test-charts The charts plugin: type check, lint, unit and golden tests.
make test-cli CLI type check and unit tests (rebuilds dist).
make test-web Console lint, unit tests and build.
make test-cloud Venom Cloud: type check, contracts, router, app and console tests, build (including the public docs).
make test-evals Eval suite type check, task validation and scoring tests, no model.
make test-python-client The Python client against a real venom serve; skipped without python3.
make test-vllm-sampler The venom-sampler/1 reference against shared vectors; skipped without python3.
make test-auto-ontology-mcp Opt-in: the vendored auto-ontology-mcp server's own tests, in a venv installed from PyPI; skipped without Python 3.12.
make test-vscode The VS Code extension, including a real venom serve and the .vsix.
make test-chrome The browser extension against a fake Chrome; no dependencies.
make test-chrome-e2e Opt-in: the extension in a real Chrome, two agents in two windows.
make test-scripts The shell-script tests: installers, gate, research keys, docs coverage, release work.
make test-sandbox-linux The sandbox escape matrix under real bubblewrap, in a privileged container.
make test-airplane The offline-capable suites in a container with --network none; any new outbound call fails it.
make lint Lint everything.
make coverage Coverage floors for the harness and CLI.
make knip A dead-code report per project; report only.
make smoke The first-run check: quick start in a clean container, compose invariants, a live stack. STAGES= picks stages, including opt-in prod, release and conformance.
make conformance The official OpenAI Python and Node SDKs against the orchestrator and a fake upstream.
make gate The pre-merge gate for a pull request (PR=<n>): merge main, then run the stages its paths need.
make backtest End-to-end backtest against a live orchestrator.
make backtest-orchestrator The live orchestrator API backtest.
make bench Orchestrator micro-benchmarks, kept in dist/bench/.
make bench-check Hot-path benchmarks against a base ref (default origin/main); fails on a regression.
make bench-baseline Re-record the committed benchmark baseline on an idle machine.
make bench-context Compaction over a scripted long session.
make bench-runtime Many scripted subagents: throughput, latency, fairness, memory.
make loadtest The orchestrator under concurrent streams: added latency, CPU, memory, soak.
make cache-report A prompt-cache report over the request log.
make canary-report A promote, hold or wait verdict for a model canary from experiment outcomes.
make escapes Rank the gates that let reverted or Fixes-escape: changes through.