SYSTEM-PERF™
Measure clearly. Stress safely. Know what your hardware can handle.
SYSTEM-PERF™ is a cross-platform terminal-native hardware diagnostic, bounded performance test, and game-readiness CLI for Windows, Linux, and macOS.
Created by Anika Mukherjee — cuteypieanika@gmail.com
What v0.3.0 does
- Deep hardware inventory: system model, motherboard, BIOS/firmware, CPU topology/clocks/cache, RAM modules/speeds, graphics adapters/VRAM/drivers, and storage devices.
- Safe multi-process CPU and RAM tests with cancellation and thermal limits where CPU sensors are available.
- NVIDIA live telemetry for temperature, power, utilization, memory use, and clocks.
- Portable temporary-file storage read/write check that cleans up after itself.
- Named-game 1080p readiness estimates using CPU results, installed RAM, GPU class, and VRAM. Includes a 1,544-title catalog.
- Interactive Terminal User Interface (TUI) powered by Questionary for easy navigation and game searching.
- Calm card-based terminal design, plus stable JSON/JSONL and Markdown output.
- Versioned, integrity-stamped result bundles and baseline comparisons.
- Safe per-user report locations, even when launched from a protected directory.
Install
python -m pip install system_perf-0.3.0-py3-none-any.whl
On Windows, use py -m pip if python is not on PATH.
Start here
system-perf
The interactive menu lets you search the game catalog, run tests, and check hardware inventory directly from an easy-to-use terminal interface.
You can also run commands directly:
system-perf doctor
system-perf detect
system-perf run full
The full profile prints measured CPU, RAM, storage, and GPU telemetry results, followed by game-readiness estimates. The saved result path is printed at the end.
Check one game during the run:
system-perf run full --game "Cyberpunk 2077"
Or evaluate an existing result:
system-perf games
system-perf games --result path/to/result.json
system-perf games --result path/to/result.json --game forza
system-perf games --search witcher
Focused tests
system-perf test cpu --duration 5 --workers 4
system-perf test memory --size 128 --rounds 8
system-perf test gpu
system-perf test storage --size 64
system-perf monitor --format jsonl --count 5
The GPU command is currently a capability and telemetry probe, not a rendered GPU benchmark. It identifies the adapters, dedicated graphics memory, drivers, current NVIDIA sensor values, and a broad model class used by the game estimator.
Supported game models
SYSTEM-PERF includes a 1,544-title game catalog based on a games-only Steam top-sellers snapshot dated 2026-06-30.
The catalog provides broad requirement tiers inferred from release cohorts and store metadata. These are generic limits and have low confidence compared to our hand-tuned models.
The 12 spotlight models (hand-tuned, medium confidence) are:
- Minecraft Java
- Valorant
- Counter-Strike 2
- Fortnite
- Grand Theft Auto V
- Forza Horizon 5
- Red Dead Redemption 2
- Elden Ring
- Cyberpunk 2077
- Hogwarts Legacy
- Starfield
- Microsoft Flight Simulator
To search the catalog, use --search:
system-perf games --search witcher
system-perf games --search "resident evil"
Game output uses four states:
- GREAT — the hardware meets the model's recommended CPU, RAM, GPU, and VRAM tiers.
- PLAYABLE — it meets the modeled minimum, usually with lower settings.
- LIMITED — at least one component is below the modeled minimum.
- UNKNOWN — there is not enough GPU evidence for a responsible estimate.
These are explainable hardware-class estimates, not guaranteed FPS. Resolution, presets, ray tracing, upscaling, drivers, cooling, background applications, mods, and game updates can materially change real performance.
Reports
Default result folders:
| Platform | Location |
|---|---|
| Windows | %LOCALAPPDATA%\SYSTEM-PERF\reports |
| macOS | ~/Library/Application Support/SYSTEM-PERF/reports |
| Linux | $XDG_STATE_HOME/system-perf/reports or ~/.local/state/system-perf/reports |
Choose a path explicitly with --output:
system-perf run full --output result.json
system-perf report result.json
system-perf report result.json --format markdown --output report.md
system-perf compare before.json after.json
Platform capabilities
| Capability | Linux | Windows | macOS |
|---|---|---|---|
| CPU/RAM/system inventory | Yes | Yes | Yes |
| Motherboard/firmware inventory | sysfs where exposed | CIM | Apple system profile |
| CPU and RAM workloads | Yes | Yes | Yes |
| Storage inventory and portable I/O test | Yes | Yes | Yes |
| Linux CPU temperature | Yes, when sysfs exposes it | — | — |
| NVIDIA telemetry | When nvidia-smi is available |
When nvidia-smi is available |
Legacy NVIDIA systems only |
| Named-game estimates | Yes | Yes | Yes, when GPU model is recognized |
| JSON/JSONL/Markdown | Yes | Yes | Yes |
Missing sensors or inventory sources are shown as unavailable and do not crash the run.
Safety and privacy
Workloads are bounded and can be cancelled with Ctrl+C. Where a supported CPU temperature sensor exists, --temperature-limit stops the CPU workload cleanly. The inventory intentionally excludes hardware serial numbers and hostnames from shared reports.
SYSTEM-PERF cannot guarantee hardware safety. Use conservative limits and adequate cooling.
License and branding
Copyright © 2026 Anika Mukherjee.
The software is licensed under the GNU Affero General Public License, version 3 or any later version (AGPL-3.0-or-later). See LICENSE.
SYSTEM-PERF™ and the original project branding are claimed as trademarks of Anika Mukherjee. See NOTICE.md. ™ is a trademark claim, not a representation of formal registration.
Metadata
Release files for system-perf 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| system_perf-0.3.1.tar.gz | 100.7 kB | Without provenance | Details for system_perf-0.3.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| system_perf-0.3.1-py3-none-any.whl | Python 3 | none | any | Details for system_perf-0.3.1-py3-none-any.whl |
Total release size: 189.5 kB
Release files / system_perf-0.3.1.tar.gz
| Download URL | system_perf-0.3.1.tar.gz |
|---|---|
| Size | 100.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9109873d17782c7db2065b752c1b87b33daca1dda53c84bb56092e1cf1c508de
|
|
BLAKE2b-256 checksum How to use checksums |
c27171389d020641d095c49f20905928f4e7aacb0a7f288675305559dd10c8e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.11
|
Release files / system_perf-0.3.1-py3-none-any.whl
| Download URL | system_perf-0.3.1-py3-none-any.whl |
|---|---|
| Size | 88.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
981e723065b1240b7be29cf79960734c53338d01e1203bd206dd3603aeeaa5fc
|
|
BLAKE2b-256 checksum How to use checksums |
1051845eaf9a46457365c2a6fd025ce78fc8935ac55e927d60809a882a1dc3f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.11
|
Security for system-perf 0.3.1
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.