Torque – DO NOT RUN OUTSIDE OF A VIRTUAL MACHINE

A lightweight system stress-testing and performance monitoring tool written in Scala with ZIO.

Scala
ZIO combinators/fibers
ZIO HTTP
OSHI

Features

CPU: monitor and test CPU performance under load
Memory: RAM stress testing with configurable memory allocation
Metrics: live system performance monitoring via an HTTP API

Quick Start

Prerequisites

Java 25
Scala 3.7.4
sbt 1.11.7

Installation

git clone https://github.com/nasrlol/torque
cd torque
sbt run

Or get it from my own git server:

git clone https://git.nsrddyn.com/torque.git
cd torque
sbt run

Usage

Start the Torque server:

sbt run

TODO: explain how to run the tests.

The server will start on http://localhost:8080 with the following endpoints:

GET /platform: API status
GET /cpu: CPU performance metrics and stress testing
GET /ram: RAM usage metrics and memory allocation tests

Example API Calls

# Check server status
curl http://localhost:8080/

# Get CPU metrics
curl http://localhost:8080/cpu

# Get RAM metrics  
curl http://localhost:8080/ram

Architecture

Torque is built using modern Scala functional programming patterns:

ZIO: for effect management and concurrency
ZIO HTTP: for a high-performance HTTP server
OSHI: for cross-platform system information

Tree

.
├── LICENSE
├── README.md
├── build.sbt
├── project
│   └── build.properties
└── src
    └── main
        └── scala
            └── main
                ├── Main.scala
                ├── domain
                │   ├── CpuOperations.scala
                │   ├── MemoryOperations.scala
                │   └── ResourceModels.scala
                ├── infrastructure
                │   ├── Http.scala
                │   ├── Resources.scala
                │   └── Routes.scala
                ├── services
                │   ├── Benchmark.scala
                │   └── Stress.scala
                └── view
                    └── View.scala

Development

Building from Source

sbt compile

API Documentation

CPU Endpoint

GET /cpu Returns CPU utilization metrics and allows initiating stress tests.

RAM Endpoint

GET /ram Returns memory usage statistics and memory allocation test results.

License

This project is licensed under the MIT License; see the LICENSE file for details.

Acknowledgments

Built with ZIO for functional effects
Uses OSHI for system information
Inspired by stress-testing tools like Linpack and Prime95