system-perf 0.1.1

Cross-platform terminal-native hardware diagnostics and safe performance profiling

SYSTEM-PERF™

Measure clearly. Stress safely. Decide confidently.

SYSTEM-PERF™ is a cross-platform terminal-native hardware diagnostic and safe performance-profiling CLI for Linux, Windows, and macOS.

Created by Anika Mukherjee — [e-mail]

What works in this first release

• Polished interactive terminal output with machine-readable JSON/JSONL modes.
• Cross-platform CPU, memory, operating-system, and architecture discovery.
• Safe, bounded multi-process CPU workloads with cancellation and thermal stops where sensors are available.
• Portable memory-copy measurements.
• NVIDIA telemetry through nvidia-smi when installed.
• Versioned, integrity-stamped result bundles.
• Workload outlooks with explicit confidence and evidence.
• Result reporting and baseline comparisons.

Temperature sensors are currently read from Linux sysfs. Windows and macOS runs remain functional and clearly mark temperature safety as unavailable until native sensor backends are added.

Install for development

python -m pip install -e .

On Windows, use py -m pip install -e . if python is not on PATH.

Quick start

system-perf doctor
system-perf detect
system-perf profiles
system-perf run quick
system-perf report <saved-result-path>

Focused and automation-friendly commands:

system-perf test cpu --duration 5 --workers 4
system-perf test memory --size 128 --rounds 8
system-perf monitor --format jsonl --count 5
system-perf detect --format json
system-perf compare before.json after.json
system-perf report <saved-result-path> --format markdown --output report.md

By default, results are saved to a per-user reports folder, even if the command is launched from a protected directory such as C:\Windows\System32. Use --output to choose another location.

Run system-perf --help for the full command list.

Safety

Workloads are bounded by duration and can be cancelled with Ctrl+C. Where a supported temperature sensor is available, --temperature-limit stops the CPU workload cleanly. This software cannot guarantee hardware safety; use conservative limits and adequate cooling.

Platform model

The commands and JSON schema are the same on every operating system. Hardware backends are capability-driven:

Capability	Linux	Windows	macOS
CPU and memory discovery	Yes	Yes	Yes
CPU and memory workloads	Yes	Yes	Yes
Linux sysfs temperature	Yes	—	—
NVIDIA via nvidia-smi	When available	When available	Legacy systems only
JSON/JSONL reporting	Yes	Yes	Yes

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.