Built for Engineers • Designed for Scale • Optimized for Performance

Overview • Features • Engine • Metrics • Installation • Quick Start • CLI • Reports • Legal • Contributing • License

BSB Havoc is a modern asynchronous load testing engine built to simulate real-world traffic patterns and measure system performance under pressure.

It provides high concurrency, low resource overhead, and accurate performance analytics — making it ideal for:

• API performance testing
• Backend stress testing
• Infrastructure benchmarking
• CI/CD performance validation

BSB Havoc is powered by a non-blocking async architecture:

• Built using asyncio + aiohttp
• Efficient connection pooling
• Persistent sessions for realistic load
• Minimal CPU & memory footprint

This allows high request throughput while keeping the testing environment stable.

During a test run, the CLI dashboard displays:

• Requests Per Second (RPS)
• Average / Min / Max Latency
• P50 / P90 / P95 / P99 Percentiles
• Success vs Failure Counts
• HTTP Status Code Distribution

All metrics update live in the terminal.

pip install bsb-havoc --upgrade

git clone https://github.com/Shawpon2/bsb-havoc.git
cd bsb-havoc
pip install -r requirements.txt
python setup.py install

bsb-havoc --version

Run a simple performance test against your own test server:

bsb-havoc https://your-server.com -c 500 -d 60

This will:

• Launch 500 concurrent virtual users
• Run for 60 seconds
• Show live performance metrics

bsb-havoc https://staging.example.com -c 1000 -d 120

bsb-havoc https://api.example.com -c 3000 -d 180 --ramp