Skip to content

AlguevaraSec/Guevara-benchmark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Guevara Benchmark

Guevara Benchmark

High-performance asynchronous HTTP load testing & benchmarking tool

Built with FastAPI, aiohttp, and asyncio for developers who need fast, lightweight, and modern API benchmarking.

Python FastAPI aiohttp License


✨ Features

  • ⚡ High-performance asynchronous requests
  • 🚀 Configurable concurrency
  • 📊 Live Requests Per Second (RPS)
  • 📈 HTTP status statistics
  • 🖥️ Modern responsive Web UI
  • 📝 Custom HTTP headers
  • 📦 GET & POST support
  • 🔒 Transparent User-Agent by default
  • 🐍 Pure Python
  • 💨 Lightweight & easy to deploy

📸 Screenshots

Dashboard


Benchmark Result


🚀 Installation

Quick Start
git clone https://github.com/AlguevaraSec/Guevara-benchmark.git

cd Guevara-benchmark

pip install -r requirements.txt

python main.py

# or

uvicorn main:app --reload

Open your browser:

http://127.0.0.1:8000

📊 Example Result

BENCHMARK COMPLETE

----------------------------------------
Total Requests : 5000
Time Elapsed   : 4.72 seconds
Throughput     : 1059.3 req/sec
----------------------------------------

HTTP 200 : 4987
HTTP 522 : 13

⚙️ Built With

Technology Purpose
FastAPI Backend Framework
aiohttp Async HTTP Client
asyncio Concurrency
Uvicorn ASGI Server
HTML / CSS / JavaScript Frontend

🛡️ Protect Your Server

Benchmarking is useful—but every public service should also be protected.

✅ Rate Limiting

Implement request limits at your application or reverse proxy.

Recommended options:

  • FastAPI Rate Limiting Middleware
  • Nginx Rate Limiting
  • Traefik Rate Limiting

☁️ Cloudflare

Cloudflare's free plan provides excellent protection for most applications.

Benefits

  • 🛡️ Layer 4 & Layer 7 DDoS Protection
  • 🔥 Web Application Firewall (WAF)
  • 🤖 Bot Protection
  • ⚡ Global CDN
  • 🚦 Rate Limiting (advanced features depend on plan)
  • 🔒 Recommended to hide your origin server IP behind Cloudflare

For small and medium-sized websites, Cloudflare is one of the easiest ways to improve availability and resilience.


⚠️ Educational & Authorized Use Only

This project is intended only for:

  • ✅ Performance testing
  • ✅ Load benchmarking
  • ✅ Capacity planning
  • ✅ Educational purposes
  • ✅ Testing systems you own or are explicitly authorized to test

Do not use this software against systems without permission.

The author assumes no responsibility for misuse or any damage caused by this software.


🤝 Contributing

Contributions are welcome!

If you'd like to improve Guevara Benchmark:

  • 🐞 Open an Issue
  • 💡 Suggest a Feature
  • 🔧 Submit a Pull Request

Every contribution is appreciated.


📄 License

Distributed under the MIT License.


⭐ If you found this project useful, consider giving it a Star!

Made with smoke by Guevara

About

🚀Lightweight HTTP load testing tool with a modern web UI. Benchmark your APIs using configurable concurrency, custom headers, and real-time performance metrics.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages