Skip to main content

perfall-cli is the standalone client package for uploading benchmark artifacts to Perfall. It is a lightweight client that can be installed independently of the server.

Install from PyPI:

pip install perfall-cli

Supported commands currently live under perfall ingest and cover:

  • pytest-benchmark

  • go-test

  • google-benchmark

  • jmh

  • criterion

  • benchmarkdotnet

  • vitest

Regression gating is available on every ingest adapter via the shared flags:

perfall ingest pytest-benchmark \
  --file benchmark.json \
  --api-key "$PERFALL_API_KEY" \
  --baseline-branch master \
  --fail-on-regression-percent 5

That upload still publishes the run, then compares each smaller-is-better metric against the latest baseline-branch sample and exits non-zero when the threshold is exceeded.

Local development:

python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e .[testing]
pytest

Release files for perfall-cli 0.1.2

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

Source distribution (sdist)

Source distribution for perfall-cli 0.1.2
File Size Uploaded
perfall_cli-0.1.2.tar.gz 19.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for perfall-cli 0.1.2
File Interpreter ABI Platform
perfall_cli-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 33.2 kB

Release files / perfall_cli-0.1.2.tar.gz

Download URL perfall_cli-0.1.2.tar.gz
Size 19.8 kB
Tags Source
SHA-256 checksum
How to use checksums
09e574bd06c90c0644fff94995501d2adad61f7c88557e04d2c09a2620202aa1
BLAKE2b-256 checksum
How to use checksums
fe852ee8dd2c9768bba800609127c9c5054b9b1e60e776940f903244fc0eb115
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 14, 2026.

Transparency log

Release files / perfall_cli-0.1.2-py3-none-any.whl

Download URL perfall_cli-0.1.2-py3-none-any.whl
Size 13.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d4c1d6107ee722b1e06ce8b7a9faa605ecf1e9cfcf7c3917381805c660b7c33f
BLAKE2b-256 checksum
How to use checksums
524f5f4538464a63c11c7600978b2461e85cce8d60b2059afca5acfe48073d10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 14, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.3

2 release files

This release

0.1.2 This release

2 release files

0.1.1

2 release files

0.1.0

2 release files

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