make targets
What each make target in a venom checkout does, for running the dev stack, building and testing.
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 startedRun 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. |