numinous

Python SDK for Numinous Cloud — build & test environments with hard TTLs, typed failure causes, export-that-survives-teardown, and per-second metering. Everything non-preemptible.

Install

pip install numinous            # SDK + CLI from PyPI
# or:
curl -fsSL https://cloud.numinous.technology/install.sh | sh

Use

from numinous import Numinous

nc = Numinous()  # NUMINOUS_API_URL / NUMINOUS_API_KEY from env

tpl = nc.templates.pack("build-env", image="ubuntu:24.04",
                        warm_cmd="apt-get update && apt-get install -y build-essential")

sb = nc.sandboxes.create(template_id=tpl["id"], vcpu=4, mem_gib=8,
                         ttl_seconds=7200, launch_token="job-1-attempt-1",
                         labels={"trial_id": "tr_1"})

nc.sandboxes.exec(sb["id"], "make -j test")
nc.sandboxes.export(sb["id"], "/logs", to="s3://bucket/tr_1/")  # works after death too
out = nc.sandboxes.destroy(sb["id"])
out["teardown_proof"]                      # {"verified_absent": true, ...}
nc.usage.query(label="trial_id:tr_1")      # per-second spans, typed unbilled faults

Typed errors

from numinous import Numinous, NuminousError

try:
    nc.sandboxes.create(...)
except NuminousError as e:
    e.cause              # "provider_capacity" | "user_image_build_failed" | ...
    e.is_provider_fault  # provider_* causes are never billed
    e.retryable

API reference: the control plane serves its own OpenAPI spec at GET /openapi.json.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

numinous-0.1.1.tar.gz (5.6 kB view details)

Uploaded Aug 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

numinous-0.1.1-py3-none-any.whl (7.0 kB view details)

Uploaded Aug 23, 2026 Python 3

File details

Details for the file numinous-0.1.1.tar.gz.

File metadata

Download URL: numinous-0.1.1.tar.gz
Upload date: Aug 23, 2026
Size: 5.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for numinous-0.1.1.tar.gz
Algorithm	Hash digest
SHA256	`1c35ad089d41b005d209fc438201188828ca0e2def8108ff95ad3801062dff29`
MD5	`b38eaee69856f4a9b0e4734ed5ae9a4b`
BLAKE2b-256	`4218d30c963faa33e278e749c1707f791c55dde9e487d954ff01ac87fb90092d`

See more details on using hashes here.

File details

Details for the file numinous-0.1.1-py3-none-any.whl.

File metadata

Download URL: numinous-0.1.1-py3-none-any.whl
Upload date: Aug 23, 2026
Size: 7.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for numinous-0.1.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`77ddb258199bad1a92cd230e02d4cbf1ea8d4409a0f6a97dc2ebbc01ff20114e`
MD5	`ee21820f92e63a15ca7a401c97248641`
BLAKE2b-256	`08c307bf5d7312b00e68dcbd1bd9ed7bb592fa468e8a30ba8ac1d41abdd199d2`