warpt 0.2.1

Performance monitoring and system utilities

warpt

A unified command-line tool for hardware discovery, stress testing, and performance monitoring.

warpt provides a vendor-agnostic interface for understanding and validating computational resources—answering questions like "What hardware do I have?", "Is it working correctly?", and "How fast is it?"

Installation

pip install warpt

For stress testing capabilities:

pip install warpt[stress]

Requirements: Python 3.8+ (3.11+ recommended) | Linux, macOS, or Windows

Quick Start

# Discover your hardware
warpt list

# Run CPU stress tests
warpt stress -c cpu

# Monitor system in real-time
warpt monitor

# Check power consumption (Linux/macOS)
warpt power

Features

Command	Description
warpt list	Detect CPU, GPU, memory, storage, and installed ML frameworks
warpt stress	Run stress tests across CPU, GPU, RAM, storage, and network
warpt monitor	Real-time system monitoring with TUI dashboard
warpt power	Power consumption monitoring and per-process attribution
warpt carbon	Track energy consumption, CO2 emissions, and estimated cost
warpt benchmark	Performance benchmarking suite

Documentation

• Getting Started — Installation and first steps
• CLI Reference — Complete command and option reference
• Support Matrix — System requirements and platform compatibility

Platform Support

Platform	Status
Linux	Full support
macOS	Full support (power monitoring requires sudo)
Windows	Limited support (see Known Limitations)

GPU Support: NVIDIA GPUs supported. AMD, Intel, and Apple Silicon GPU support coming soon.

Carbon Tracking

warpt automatically tracks energy usage and CO2 emissions during stress tests and power monitoring. You can also track any workload manually:

# Automatic — built into stress tests
warpt stress -c cpu -d 30
# [carbon] 30.2s | 23.8W avg | 199.7 mWh | 0.08g CO2 | $0.0000 | less than breathing for a minute

# Manual — track any workload
warpt carbon start
# ... run your workload ...
warpt carbon stop

# View history and totals
warpt carbon history
warpt carbon summary

# Check available grid regions and carbon intensities
warpt carbon regions

Carbon calculations use regional grid intensity data to estimate CO2 emissions from energy consumption. Configure your region with --region (defaults to US).

Example Output

$ warpt list

CPU Information:
  Make:               Intel
  Model:              Xeon W-2295
  Architecture:       x86_64

Topology:
  Total Sockets:      1
  Total Phys Cores:   18
  Total Logic Cores:  36

Memory Information:
  Total:              128.0 GB
  Type:               DDR4

GPU Information:
  GPU 0: NVIDIA RTX 4090
    Memory: 24576 MB
    Driver: 545.23.08

Alpha Release

This is an alpha release. Some features are still in development:

• Carbon tracking — new in v0.2.0
• AMD GPU support (ROCm) — in progress
• Intel GPU support (oneAPI) — in progress
• Apple Neural Engine — in progress
• Additional benchmarks — expanding

See the Support Matrix for full details.

Feedback

We'd love to hear from you:

• Report bugs: GitHub Issues
• Feature requests: GitHub Issues

License

MIT License — see LICENSE for details.