Install numi
Build and run the open numi CLI from a source checkout. Release binaries and Homebrew are planned and have no commands yet.
Building from source is the only available method. Other methods are planned.
The only real install today is a source build with the Go toolchain. Installing numi does not install the Numinance engine.
Prerequisites
A Go toolchain that satisfies go.mod: go 1.27, toolchain go1.27.3. See the shared install guide for the wider setup this page shares wording with.
Install methods
Pre-alpha Available.
git clone https://github.com/dsha256/numinance-spec.git
cd numinance-spec
go run ./cli/numi versionTo produce a binary instead of running through go run:
go build -o ./bin/numi ./cli/numi
./bin/numi versionA prebuilt open CLI built from the checkout this site documents printed:
0.0.0-devCheck that it works
./bin/numi validate --files schemas/examples/AutonomyPolicyrevision: "files"
ok file "org-ladder.yaml" AutonomyPolicy "org-ladder"Run the repository's tests for the command with go test ./cli/... ./sdk/go/cli ./sdk/go/evidenceverify from the checkout root.
Failure modes
| Symptom | Cause | Response |
|---|---|---|
| Toolchain download or version error | Local Go older than go.mod | Install a Go toolchain that meets go.mod |
numi: command not found | You built to ./bin/numi and did not put it on PATH | Run it by path, or add the directory to PATH yourself |
| Relative example paths not found | You ran the binary from another directory | Run from the checkout root |
What this does not give you
The open build validates, scaffolds and verifies. It cannot resolve a profile, run a change, export evidence or reach a runtime. See open build versus engine build.