Skip to Content
Numinance
Get started

Get started

Choose a path by role and run the first three steps against the public numinance-spec tree.

View as .mdUpdated
Available in public spec
Everything on this page runs from a source build of the open numi CLI. Nothing here installs or starts the Numinance engine.
Numinance is pre-alpha. The open surface lets you configure, validate, build against and verify; the autonomous runtime is private and not generally available.

Before you start

You need Git and a Go toolchain that satisfies the repository's go.mod: go 1.27 with toolchain go1.27.3. Every command on these pages runs from the root of a clone of https://github.com/dsha256/numinance-spec.git. The install page shows the clone and the build.

Three distinct objects are in play: the open numi CLI, the numinance-spec repository, and the proprietary runtime. These pages only touch the first two.

Choose your path

You want to build against the contract: a plugin, a client, a configuration.

  1. Build numi from source and confirm numi version prints 0.0.0-dev.
  2. Build the sample knowledge plugin and see why it refuses to run by hand.
  3. Read the Go SDK and the plugin service, then follow Build a custom plugin.

What you can and cannot do today

You canYou cannot
Build numi from source and run version, init, validate, evidence verify.Download a release binary or install with a package manager. Both are planned, not published.
Scaffold and validate .numinance/ configuration.Resolve a profile or run a change. Open numi validate exits 7 after the schema pass.
Build and inspect the sample plugin and the conformance kits.Install a generated Python or TypeScript package, or a Rust or Java SDK.
Verify an evidence/v1 export offline.Export evidence with the open build. numi evidence export is not in it.

Next steps

On this page