Skip to content
kurok edited this page Mar 11, 2026 · 3 revisions

Welcome to pywrkr

pywrkr is a tool that helps you test how fast your website or API can handle traffic. Think of it like a stress test for your server.

You send a bunch of requests to your server, and pywrkr tells you:

  • How many requests per second your server handled
  • How fast (or slow) each response was
  • Whether any requests failed

Quick Navigation

Page What you'll learn
Installation How to install pywrkr on your machine
Your First Test Run your very first benchmark in 2 minutes
Basic Examples Common use cases with copy-paste commands
Testing Multiple URLs Test many endpoints at once from a file
Simulating Real Users Make your test look like real people browsing
Rate Limiting Control exactly how many requests per second to send
Traffic Profiles Shape traffic with sine waves, spikes, CSV replay, and more
Finding Server Limits Automatically discover your server's maximum capacity
SLO Thresholds for CI Use in CI/CD pipelines with pass/fail checks
Distributed Testing Run tests from multiple machines at once
Output Formats Save results as JSON, CSV, or HTML
Monitoring Integration Send results to Prometheus or OpenTelemetry
All CLI Options Complete reference of every flag and option

What does pywrkr mean?

It's short for "Python Worker" — a Python-based HTTP benchmarking tool inspired by wrk and Apache ab.

Clone this wiki locally