Skip to main content

CueApril for Python package managers

This package runs the same CueApril CLI as the npm package. Python 3.10 or later and an installed Node.js 20 or later are required. It bundles the CLI's JavaScript and skill; it installs no Python runtime dependencies, runs no npm install and downloads no runtime when launched.

Install with your usual Python package manager:

pipx install cueapril
cueapril init

# Or run in an isolated environment:
uvx cueapril init

# A regular Python environment also works:
python -m pip install cueapril
python -m cueapril --help

Have node on PATH before running these commands. The launcher checks its version and replaces itself with the bundled CLI, preserving arguments, environment, standard input/output and exit status. It reports a missing or old Node.js installation with exit code 5. It does not install Node.js for you. Choose either the Python or npm installation for your normal cueapril command; both expose that command name.

A coding agent can start with uvx cueapril init --no-login --json. If the result says auth_required, ask the person to provide an organisation agent key through their secret manager as CUEAPRIL_API_KEY, or offer one browser approval with uvx cueapril init --no-wait --no-browser --json. Never ask them to paste a key into a chat or command argument. Resume with uvx cueapril init --json after approval. An existing key can also be piped directly from a secret manager into uvx cueapril init --key-stdin --json.

cueapril init connects a coding agent through one browser approval. It then checks project setup and can configure Claude Code, Codex, Gemini CLI and Cursor. A scoped agent key can also come from the CUEAPRIL_API_KEY environment variable. Use CUEAPRIL_URL to select another API origin. The Python launcher never reads, prints or passes a key as a command-line argument; it preserves the existing CLI environment and credential-store behavior.

cueapril projects
cueapril setup --project PROJECT_ID
cueapril assess --pr https://github.com/OWNER/REPO/pull/42 --wait --json
cueapril status ASSESSMENT_ID --json
cueapril wait ASSESSMENT_ID --timeout 4 --json
cueapril results ASSESSMENT_ID --all --json
cueapril mcp-config --client codex

Assessment exit codes are unchanged: 0 passed; 1 failed; 2 incomplete or cancelled; 3 blocked; 4 still running; 5 usage, authentication, API or launcher error. A CLI wait timeout leaves the assessment running. Each server wait call lasts at most 50 seconds.

The complete CLI reference is bundled in cueapril/_cli/README.md; public setup documentation is at https://app.cueapril.com/agents. The Python package contains the same Node modules, package metadata and cueapril-qa skill as the unscoped npm package.

Source maintenance

From the CueApril repository, synchronize the bundled CLI after a change:

node packages/quality-python/scripts/sync-cli.mjs --sync --repository-root .
node packages/quality-python/scripts/sync-cli.mjs --check --repository-root .
python -m unittest discover -s packages/quality-python/tests

The sync script uses the repository's canonical npm package builder in a temporary directory with packing disabled. It compares every bundled file and records deterministic hashes in bundled-cli.json; --check fails if a file, version or manifest differs. It performs no npm command or network request. The initial release additionally compares the source with the independently reviewed npm staging directory. A distribution build includes those already reviewed bytes and does not fetch or rewrite the bundled CLI.

Metadata

Release files for cueapril 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cueapril 1.2.0
File Size Uploaded Provenance Actions
cueapril-1.2.0.tar.gz 82.5 kB With provenance Details for cueapril-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cueapril 1.2.0
File Interpreter ABI Platform Actions
cueapril-1.2.0-py3-none-any.whl Python 3 none any Details for cueapril-1.2.0-py3-none-any.whl

Total release size: 168.0 kB

Release files / cueapril-1.2.0.tar.gz

Download URL cueapril-1.2.0.tar.gz
Size 82.5 kB
Tags Source
SHA-256 checksum
How to use checksums
bc6be94e9bc91fe101bcaf6292c6b1336caf161845b29aa3d580884ee04adc99
BLAKE2b-256 checksum
How to use checksums
8c909e5f950efec0f59cb760800d87808f13249fe96c2e8b595a8df4992f423e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / cueapril-1.2.0-py3-none-any.whl

Download URL cueapril-1.2.0-py3-none-any.whl
Size 85.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
22fb7bc44e0893a2c1e64af942086b10e16190a9488692e80f6f959afac9f61f
BLAKE2b-256 checksum
How to use checksums
95b37661664949a700a69227af16ecd98457345622bdb47e05403d56cf03dedc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for cueapril 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cueapril-1.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page