CLI

Installed with the SDK (pip install numinous) or via curl -fsSL https://cloud.numinous.technology/install.sh | sh. Every command prints JSON, so output pipes straight into jqand CI scripts. exec passes through stdout, stderr, and the exit code.

Commands

numinous template pack --name build-env --image ubuntu:24.04 \
    --warm "apt-get update && apt-get install -y build-essential"
numinous template list

numinous boot tpl_9f2 --vcpu 4 --mem 8 --ttl 7200 \
    --label trial_id=tr_1 --token job-1 --count 1

numinous exec sbx_a1b2 "make -j test"      # exit code passes through
numinous suspend sbx_a1b2
numinous resume  sbx_a1b2
numinous export  sbx_a1b2 /logs --to s3://bucket/tr_1/
numinous destroy sbx_a1b2                  # prints teardown proof

numinous ls --label trial_id=tr_1 --state running
numinous usage --label trial_id=tr_1
numinous capacity
numinous pricing

Exit codes

0	success (or the exec'd command's own exit code)
1	user-class error (bad image, bad request); retrying won't help
75	provider-class error (capacity, infra); retryable and unbilled

75 is EX_TEMPFAIL: CI systems can retry on it mechanically without parsing anything.

For coding agents

Paste this into Claude Code, Codex, or Cursor to set up and verify access:

Set up Numinous Cloud in this repository.
1. Run: curl -fsSL https://cloud.numinous.technology/install.sh | sh
2. Ask me for NUMINOUS_API_URL and NUMINOUS_API_KEY, export them.
3. Verify with: numinous capacity && numinous pricing
4. Read https://cloud.numinous.technology/llms.txt for the full API surface.
Reply exactly "numinous is connected" when every step succeeds.