From 23c5d68d415396ba61bc6426a0370e9347d67a33 Mon Sep 17 00:00:00 2001
From: Abdellah El Morabit <nsrddyn@gmail.com>
Date: Sun, 30 Nov 2025 16:31:02 +0100
Subject: feature: readme

---
 README.md | 145 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 145 insertions(+)

diff --git a/README.md b/README.md
index 2a50d9f..b364d4a 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,147 @@
 # torque
 A lightweight system stress-testing tool written in Scala.
+
+# Torque 🔧
+
+A lightweight system stress-testing and performance monitoring tool written in Scala with ZIO.
+
+Scala
+ZIO 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 HTTP API
+
+## Quick Start
+
+### Prerequisites
+
+- Java 25
+- Scala 3.7.4
+- sbt 1.11.7
+
+### Installation
+
+```bash
+git clone https://github.com/nasrlol/torque
+cd torque
+sbt run
+```
+Or get it from my gitea
+
+```bash
+git clone https://git.nsrddyn.com/nasr/torque
+cd torque
+sbt run
+```
+
+### Usage
+
+Start the Torque server:
+```bash
+sbt run
+```
+
+TODO: Explanation on how to run the tests
+
+The server will start on `http://localhost:8080` with the following endpoints:
+
+- `GET /` - API status
+- `GET /cpu` - CPU performance metrics and stress testing
+- `GET /ram` - RAM usage metrics and memory allocation tests
+
+### Example API Calls
+
+```bash
+# 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 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
+│               ├── infrastructure
+│               │   ├── Http.scala
+│               │   ├── Resources.scala
+│               │   └── routes
+│               │       └── Routes.scala
+│               └── services
+│                   ├── Benchmark.scala
+│                   └── Stress.scala
+
+```
+
+## Development
+
+### Building from Source
+
+```bash
+sbt compile
+```
+
+### Creating a Fat JAR
+
+```bash
+sbt assembly
+```
+
+## Configuration
+
+Torque can be configured via environment variables:
+
+- `TORQUE_PORT` - HTTP server port (default: 8080)
+- `TORQUE_HOST` - Server host (default: localhost)
+
+## 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](LICENSE) file for details.
+
+## Acknowledgments
+
+- Built with [ZIO](https://zio.dev/) for functional effects
+- Uses [OSHI](https://github.com/oshi/oshi) for system information
+- Inspired by stress testing tools like `Linkpack` and `PRIME95`
+```
-- 
cgit v1.2.3-70-g09d2