px is distributed as the prometheux package on PyPI. It requires Python ≥ 3.9.

​
Install

uv installs px into its own isolated environment with its own Python — nothing to manage. Upgrade with uv tool upgrade prometheux.

​
One-liner installers

The installer prefers uv (bootstrapping it if absent), then pipx, then pip --user. Pin a release with PROMETHEUX_VERSION; skip the uv bootstrap with PROMETHEUX_NO_BOOTSTRAP=1.
Native Windows is a first-class target. If px isn’t found after install, restart your shell (uv/pipx add their bin directory to PATH on first install).

​
From source (development)

​
Authenticate

Most commands need a platform URL and an API token. init and validate do not.
  • Credentials persist to ~/.prometheux/config.json.
  • Omit --token to be prompted with hidden input.
  • --no-verify stores the credentials without the live auth check.
  • The default URL is http://localhost:8000 (local dev; token devtoken).
The base URL is .../jarvispy/<org>/<user> with no /api suffix — the SDK appends /api/v1 itself. For example: https://api.prometheux.ai/jarvispy/prometheux/alice.

​
CI / scripts

Skip px login and set environment variables instead — they override the stored config, so no file is needed in CI:
See CI/CD for a full GitHub Actions example.

​
Add the agent skill

Once px is installed, give your coding agent full knowledge of how to author workspaces — no repo to clone:
See Agent skill for details.

​
Corporate / enterprise install

px is built to pass locked-down security review:
  • Standard wheel + sdist on PyPI — proxy it through your internal Artifactory/Nexus mirror and pip install prometheux with your sanctioned Python. No bespoke installer needed.
  • Proxy + corporate CA — the CLI honours HTTPS_PROXY, NO_PROXY, PIP_INDEX_URL, and REQUESTS_CA_BUNDLE / SSL_CERT_FILE, so it works behind a TLS-intercepting proxy.
  • Minimal dependency tree — a small, mainstream set of dependencies (fewer approval items).
  • Provenance — every release ships a CycloneDX SBOM, SHA256 checksums, and a Sigstore build-provenance attestation; PyPI uploads carry PEP 740 attestations.
curl … | sh from the public internet is a self-serve convenience, not the enterprise path. For banks and other locked-down environments, install the signed wheel from your internal mirror with your own Python.

​
Verify

Next: the Quickstart.