AI repository intelligence

FR-AI / ANALYSIS

Why it is worth attention

It combines the simplicity of a web-based interface with the power of asynchronous Python to deliver real-time throughput statistics and HTTP status distribution, making load testing accessible and visually informative.

Who it is for

Developers needing quick API performance checks
DevOps engineers performing capacity planning
Students learning about asynchronous benchmarking
QA engineers testing service reliability under load

Use cases

Benchmarking REST API endpoints during development
Comparing performance of different backend configurations
Stress-testing personal or authorized servers for capacity planning
Demonstrating async Python performance concepts in educational settings

Strengths

Real-time live RPS and HTTP status statistics in a responsive web UI
Lightweight and easy to deploy with minimal dependencies (pure Python, FastAPI, aiohttp)
Configurable concurrency and support for GET/POST requests with custom headers
Clear example output showing throughput and error breakdown

Considerations

Supports only GET and POST HTTP methods (no PUT, DELETE, etc.)
Web UI may not be suitable for headless or automated CI/CD pipelines
Performance ceiling limited by Python's async runtime compared to compiled tools for very high load

README quick start

⚡ 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.

✨ 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

Description

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

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo

Featured

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents

2,390

slvDev

Featured

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models

1,960

littledivy

Featured

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning

1,482