pyperformance

library1.14.0pypypiunverified

The official Python benchmark suite for CPython. Provides a collection of benchmarks used to measure and compare performance of Python versions and implementations. Current version is 1.14.0, with regular releases as CPython evolves. Requires Python >=3.10.

testing devops

pip install pyperformance

github ↗package ↗

INSTALL

IMPORT

SIG · PYPERFORMANCE

pyperformance

testingpythonv1.14.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Run pyperformance benchmarks from Python code using subprocess. For CLI usage, run `python -m pyperformance run` directly.

import subprocess import sys # Run all benchmarks once subprocess.run([sys.executable, '-m', 'pyperformance', 'run'], check=True) # Run a specific benchmark subprocess.run([sys.executable, '-m', 'pyperformance', 'run', '--bench', 'crypto_pyaes'], check=True)

pyperformance --version

Debug

Known issues

gotchapyperformance is a CLI tool, not a library with importable modules. There is no `import pyperformance` for programmatic use; always invoke via subprocess or shell.

fix

Use `subprocess.run(['python', '-m', 'pyperformance', 'run'])` or run the `pyperformance` command directly from the terminal.

affects: all

gotchaBenchmark results are sensitive to machine state. Running with insufficient warmup or background processes can produce unreliable data.

fix

Close all other applications, disable CPU scaling, and use `--strict` for reproducible results.

affects: all

deprecatedPython 3.9 and earlier are no longer supported. Running on older Python may fail or produce errors.

fix

Upgrade to Python 3.10 or newer.

affects: <3.10

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'pyperformance'

pyperformance is not a Python module that can be imported; it's a CLI tool.

fix

Do not import pyperformance. Use `python -m pyperformance` or run the `pyperformance` command directly.

usage: pyperformance [-h] {run,list,show,compile} ... pyperformance: error: unrecognized arguments: --bench=...

Using an incorrect CLI syntax, e.g. `--bench=name` instead of `--bench name` or `--benchmarks name`.

fix

Use `--bench` or `--benchmarks` with a space: `pyperformance run --bench crypto_pyaes`.

ValueError: The number of loops must be at least 1

Running with `--loops=0` or a negative value; pyperformance internally requires at least 1 loop.

fix

Provide a positive integer to `--loops` (e.g., `--loops=5`) or omit the flag to let pyperformance decide.

Upgrade

Version history

1.14.0latest on PyPI · released Feb 7, 2026

Audit

Dependencies

pyperfrequiredCore dependency for running benchmarks and producing results.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/python/pyperformance ↗

packagehttps://pypi.org/project/pyperformance/ ↗