Quickstart

Step 1: Clone and onboard

git clone <your-repo-url> BIOMETRICS
cd BIOMETRICS
./biometrics-onboard

Verify onboarding output

Run cat .biometrics/onboard/report.json and confirm no blocking failures.

Expected output: ready=true

Step 2: Start control plane

cd biometrics-cli
go run ./cmd/controlplane

Verify health

In another terminal, run curl -fsS http://127.0.0.1:59013/health (opens in a new tab).

Expected output: {"status":"ok"}

Step 3: Start first run

curl -fsS -X POST http://127.0.0.1:59013/api/v1/runs \
  -H "Content-Type: application/json" \
  -d '{"project_id":"biometrics","goal":"quickstart run","mode":"autonomous"}'

Verify run id

Response must include a non-empty run ID and an initial status.

Expected output: "id":"run-..."

Definition of done (quickstart)

  • Onboarding finished without blocking failures.
  • Control plane health endpoint returns status=ok.
  • A run can be created through /api/v1/runs.
  • Tasks endpoint for that run returns at least one task.

Continue

HomeInstall Hub