Volta

Distributed load testing system for HTTP services with AI-powered analysis.

volta-demo.mp4

Prerequisites

• Java 21+

Quick Start

1. Build

git clone <repo-url>
cd volta
./mvnw package -DskipTests

2. Start the Agent (Terminal 1)

The Agent listens for commands on port 7070 by default.

java -jar volta-agent/target/volta-agent-1.0-SNAPSHOT.jar

Expected output:

Agent started on port 7070

3. Run the Master (Terminal 2)

Option A (recommended): run from config file

Create a config file (JSON/YAML). Example config.json:

{
  "url": "https://httpbin.org/get",
  "rps": 5,
  "duration": 10
}

Or config.yaml:

url: "https://httpbin.org/get"
rps: 5
duration: 10

Run:

java -jar volta-master/target/volta-master-1.0-SNAPSHOT.jar \
  --config=./config.json \
  --agent=localhost:7070

Option B (legacy, still supported): pass parameters via CLI flags

java -jar volta-master/target/volta-master-1.0-SNAPSHOT.jar \
  --url=https://httpbin.org/get \
  --rps=5 \
  --duration=10 \
  --agent=localhost:7070

Expected output:

[RPS: 0 | Success: 0.0% | Avg: 0ms | Errors: 0]
[RPS: 4 | Success: 100.0% | Avg: 353ms | Errors: 0]
...
[RPS: 5 | Success: 100.0% | Avg: 212ms | Errors: 0]

========= FINAL STATS =========
Total Requests:  50
Success:         50
Errors:          0
Success Rate:    100.00%
Avg Latency:     211.72ms
Min Latency:     114ms
Max Latency:     863ms
===============================

Contributing

See CONTRIBUTING.md for development workflow, issue and pull request guidelines, and code style.

License

MIT