perfratioCLI

THE PERFORMANCE MEASUREMENT TOOLKIT

Joining Better Web ↗

Every optimization
has a trade-off.

A faster command. A smaller footprint. But at what cost? perfratio measures time, memory and energy, so you can see the whole picture.

RUST / Linux · macOS · Windows

EXPERIMENT 001ILLUSTRATIVE DATA
RELATIVE SPEED1.60×

./optimized vs. ./baseline

148.2 ms → 92.6 ms
ELAPSED TIMEms

148.2 → 92.6

PEAK MEMORYMB

24.0 → 18.2

* Speed alone never tells the whole story.

EXPLORE THE DIMENSIONS

01 / THE WHOLE PICTURE

Fast is only part
of the equation.

A faster command is a good start. Knowing its resource cost and whether the difference is meaningful is a better benchmark.

01TIME

Every run tells a story.

Mean, median, standard deviation, user and system CPU time. Compare commands with relative performance ratios.

02MEMORY

See the memory footprint.

Track peak resident memory alongside execution time. Understand the resource cost behind an optimization.

03ENERGY

Efficiency beyond speed.

Measure energy in Joules and average power in Watts with supported hardware sensors, including Linux RAPL.

04STATISTICS

Put confidence in the result.

Bootstrap confidence intervals and two-sample significance tests with --deep-stats.

02 / YOUR WORKFLOW

Familiar commands.
Deeper answers.

Built on the heritage of hyperfine and joulex. Bring your existing shell commands and explore more of what happens when they run.

Explore the getting-started guide →
  1. 01

    Prepare a fair comparison

    Warm up caches, check the system and interleave runs.

  2. 02

    Measure what matters

    Compare runtime and memory. Add energy and deep statistics.

  3. 03

    Take the evidence with you

    Export JSON, CSV, Markdown or a standalone HTML report.

03 / IN THE TERMINAL

Your next benchmark
starts here.

perfratio --warmup 3 'grep -R TODO src' 'rg TODO src'

Compare shell commands with warmup runs before measurement.

04 / GET STARTED

Less setup.
More insight.

Install from the source repository with Cargo. Requires Rust 1.88 or newer.

Explore releases ↗
BUILD FROM SOURCE
cargo install --git https://github.com/UnitedOpen-Source/perfratio --locked perfratio
RUN YOUR FIRST BENCHMARK
perfratio --warmup 3 'sleep 0.1' 'sleep 0.2'

Need help reading the results? Follow the guide →

OPEN SOURCE. OPEN POSSIBILITIES.

Better benchmarks.
Built together.

perfratio is moving into the Better Web ecosystem. Explore the code, report an issue or help shape what comes next.