PyPI · #1189 most downloaded on PyPI

locust

2.46.79.9M downloads/molocustio/locust ↗New releases in your daily digest, changelog included.

Developer-friendly load testing framework

Last release today
04 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
1050 releases · first in 2020

Release timeline

1050 releases since 2020

2020202120222023202420252026

20202026

One column per quarter.

Releases

2.9.1.dev4527 Jun 2022pre-release
Nothing published for this version
2.9.1.dev3817 Jun 2022pre-release
Nothing published for this version
2.9.1.dev3016 Jun 2022pre-release
Nothing published for this version
2.9.1.dev231 Jun 2022pre-release
Nothing published for this version

2.9.1.dev131 Jun 2022pre-release

Nothing published for this version

2.9.1.dev1125 May 2022pre-release

Nothing published for this version

2.9.1.dev319 May 2022pre-release

Nothing published for this version

2.9.019 May 2022

Ensure test_start is run to completion on worker by @mboutet in https://github.com/locustio/locust/pull/2072

What's Changed

Ensure test_start is run to completion on worker by @mboutet in https://github.com/locustio/locust/pull/2072
modernized build by @mgor in https://github.com/locustio/locust/pull/2070
Drop support for Python 3.6 by @cyberw in https://github.com/locustio/locust/pull/2080
Add table linkage, you can see the data of the three tables at the sa… by @helloNice in https://github.com/locustio/locust/pull/2082
uniform style of stats/report ascii tables by @mgor in https://github.com/locustio/locust/pull/2084
Move CSV stats printer gevent spawn up a few lines by @max-rocket-internet in https://github.com/locustio/locust/pull/2085
FastHttpUser improvements (including a rename of parameter "url" to "path") by @mgor in https://github.com/locustio/locust/pull/2083
print_stats table width fix for #2084 by @mgor in https://github.com/locustio/locust/pull/2088
Remove explicit version requirement for jinja2 by @cyberw in https://github.com/locustio/locust/pull/2090
dispatch: rebalance users with a fixed count by @andydunstall in https://github.com/locustio/locust/pull/2093
avoid using pyzmq 23. Fixes #2099 by @cyberw in https://github.com/locustio/locust/pull/2100

New Contributors

@helloNice made their first contribution in https://github.com/locustio/locust/pull/2082
@andydunstall made their first contribution in https://github.com/locustio/locust/pull/2093

Full Changelog: https://github.com/locustio/locust/compare/2.8.6...2.9.0

Open source →

Additional notes

FastHttpUser improvements (including a rename of parameter "url" to "path") https://github.com/locustio/locust/pull/2083
Modernized build https://github.com/locustio/locust/pull/2070
Drop support for Python 3.6 https://github.com/locustio/locust/pull/2080
Add table linkage in UI https://github.com/locustio/locust/pull/2082
Uniform style of stats/report ascii tables https://github.com/locustio/locust/pull/2084
Remove explicit version requirement for jinja2 https://github.com/locustio/locust/pull/2090
Rebalance users even when using fixed_count https://github.com/locustio/locust/pull/2093
Avoid using incompatible pyzmq 23 https://github.com/locustio/locust/pull/2100

Open source →

2.8.7.dev3419 May 2022pre-release

Nothing published for this version

2.8.7.dev329 May 2022pre-release

Nothing published for this version

2.8.7.dev305 May 2022pre-release

Nothing published for this version

2.8.7.dev284 May 2022pre-release

Nothing published for this version

2.8.7.dev233 May 2022pre-release

Nothing published for this version

2.8.7.dev172 May 2022pre-release

Nothing published for this version

2.8.7.dev152 May 2022pre-release

Nothing published for this version

2.8.7.dev1328 Apr 2022pre-release

Nothing published for this version

2.8.7.dev1126 Apr 2022pre-release

Nothing published for this version

2.8.7.dev816 Apr 2022pre-release

Nothing published for this version

2.8.7.dev413 Apr 2022pre-release

Nothing published for this version

2.8.67 Apr 20222 sources agree

Support sharing connection pools between users by @miedzinski in https://github.com/locustio/locust/pull/2059

What's Changed

Support sharing connection pools between users by @miedzinski in https://github.com/locustio/locust/pull/2059
Add cpu_warning event, so listeners can do some action when CPU usage is too high by @cyberw in https://github.com/locustio/locust/pull/2067

New Contributors

@miedzinski made their first contribution in https://github.com/locustio/locust/pull/2060
@kurtmckee made their first contribution in https://github.com/locustio/locust/pull/2062
@chalex2k made their first contribution in https://github.com/locustio/locust/pull/2064

Full Changelog: https://github.com/locustio/locust/compare/2.8.5...2.8.6

Open source →

2.8.6.dev256 Apr 2022pre-release

Nothing published for this version

2.8.6.dev236 Apr 2022pre-release

Nothing published for this version

2.8.6.dev1630 Mar 2022pre-release

Nothing published for this version

2.8.528 Mar 2022Breaking2 sources agree

Fix dependency: Dont use latest Jinja2 because it has breaking changes

Fix dependency: Dont use latest Jinja2 because it has breaking changes

What's Changed

fix some typos by @cuishuang in https://github.com/locustio/locust/pull/2052

New Contributors

@cuishuang made their first contribution in https://github.com/locustio/locust/pull/2052

Full Changelog: https://github.com/locustio/locust/compare/2.8.4...2.8.5

Open source →

2.8.5.dev217 Mar 2022pre-release

Nothing published for this version

2.8.415 Mar 2022

Add test_stopping event by @marcinh in https://github.com/locustio/locust/pull/2033

What's Changed

Add test_stopping event by @marcinh in https://github.com/locustio/locust/pull/2033
fixed load/users getting distributed to missing worker by @radhakrishnaakamat in https://github.com/locustio/locust/pull/2010
Bugfix/1947 locust does not stop all users by @marcinh in https://github.com/locustio/locust/pull/2041
fixing mypy errors with loosest rules by @mgor in https://github.com/locustio/locust/pull/2040
Add quit event, used for getting locust's exit code just before exit by @DennisKrone in https://github.com/locustio/locust/pull/2049

New Contributors

@marcinh made their first contribution in https://github.com/locustio/locust/pull/2033
@radhakrishnaakamat made their first contribution in https://github.com/locustio/locust/pull/2010
@mgor made their first contribution in https://github.com/locustio/locust/pull/2040

Full Changelog: https://github.com/locustio/locust/compare/2.8.3...2.8.4

Open source →

Additional notes

New event: test_stopping, triggered just before stopping the test https://github.com/locustio/locust/pull/2033
New event: quit, to enable getting the locust process exit code https://github.com/locustio/locust/pull/2049
Fix users sometimes not being stopped correctly https://github.com/locustio/locust/pull/2041

Open source →

2.8.4.dev248 Mar 2022pre-release

Nothing published for this version

2.8.4.dev184 Mar 2022pre-release

Nothing published for this version

2.8.4.dev151 Mar 2022pre-release

Nothing published for this version

2.8.4.dev81 Mar 2022pre-release

Nothing published for this version

2.8.325 Feb 20222 sources agree

Bump minimum required gevent version to 20.12.1 by @cyberw in https://github.com/locustio/locust/pull/2023

What's Changed

Bump minimum required gevent version to 20.12.1 by @cyberw in https://github.com/locustio/locust/pull/2023
Fix typos by @kianmeng in https://github.com/locustio/locust/pull/2022
Ensure users are distributed evently across hosts during ramp up by @cyberw in https://github.com/locustio/locust/pull/2025
Ran pyupgrade on the code base, removing various "Python2-isms". by @cyberw in https://github.com/locustio/locust/pull/2032

Full Changelog: https://github.com/locustio/locust/compare/2.8.2...2.8.3

Open source →

2.8.3.dev1525 Feb 2022pre-release

Nothing published for this version

2.8.3.dev822 Feb 2022pre-release

Nothing published for this version

2.8.3.dev522 Feb 2022pre-release

Nothing published for this version

2.8.3.dev321 Feb 2022pre-release

Nothing published for this version

2.8.214 Feb 2022

Fix locust version in docker image (lose the .dev0) by @cyberw in https://github.com/locustio/locust/pull/2014

What's Changed

Fix locust version in docker image (lose the .dev0) by @cyberw in https://github.com/locustio/locust/pull/2014
Dockerfile: Fix permissions in venv to allow installing packages in derived images by @cyberw in https://github.com/locustio/locust/pull/2016

Full Changelog: https://github.com/locustio/locust/compare/2.8.1...2.8.2

Open source →

Additional notes

Fix issue with permissions in docker image

Open source →

2.8.2.dev714 Feb 2022pre-release

Nothing published for this version

2.8.2.dev413 Feb 2022pre-release

Nothing published for this version

2.8.113 Feb 2022

Dockerfile: use a builder image to further optimize image size by @cyberw in https://github.com/locustio/locust/pull/2013

What's Changed

Dockerfile: use a builder image to further optimize image size by @cyberw in https://github.com/locustio/locust/pull/2013

Full Changelog: https://github.com/locustio/locust/compare/2.8.0...2.8.1

Open source →

Additional notes

Further optimize docker image (60MB compressed)

Open source →

2.8.1.dev313 Feb 2022pre-release

Nothing published for this version

2.8.013 Feb 2022

Shrink Locust's docker image from 358MB to 95MB. Mainly by basing it on python3.9-slim instead of python3.9.

What's Changed

Fix empty tasks section in UI and static report bug by @EzR1d3r in https://github.com/locustio/locust/pull/2001
Mark package as being typed and add some missing type hints by @RobertCraigie in https://github.com/locustio/locust/pull/2003
Fix link to distributed load generation documentation in CPU log warning by @mayaCostantini in https://github.com/locustio/locust/pull/2007
Shrink docker image, mainly by switching base image to python3.9-slim by @cyberw in https://github.com/locustio/locust/pull/2009
Dockerfile: only install build dependencies on arm64 (everyone else has pre-built wheels) by @cyberw in https://github.com/locustio/locust/pull/2011

New Contributors

@RobertCraigie made their first contribution in https://github.com/locustio/locust/pull/2003
@mayaCostantini made their first contribution in https://github.com/locustio/locust/pull/2007

Full Changelog: https://github.com/locustio/locust/compare/2.7.3...2.8.0

Open source →

Additional notes

Shrink docker image significantly (95MB compressed size for x64 instead of 358MB) by basing the image on python3-slim instead of python3
Fix empty tasks section in UI and static report bug (really) https://github.com/locustio/locust/pull/2001

Open source →

2.7.4.dev2312 Feb 2022pre-release

Nothing published for this version

2.7.4.dev1911 Feb 2022pre-release

Nothing published for this version

2.7.4.dev1311 Feb 2022pre-release

Nothing published for this version

2.7.36 Feb 20222 sources agree

Fix 'Tasks' section remains empty in web ui @tyge68 in https://github.com/locustio/locust/pull/1997

What's Changed

Fix 'Tasks' section remains empty in web ui @tyge68 in https://github.com/locustio/locust/pull/1997
Support locust-plugin's Playwright User: Import trio before gevent patching if LOCUST_PLAYWRIGHT is set by @cyberw in https://github.com/locustio/locust/pull/1999

Full Changelog: https://github.com/locustio/locust/compare/2.7.2...2.7.3

Open source →

2.7.3.dev46 Feb 2022pre-release

Nothing published for this version

2.7.3.dev24 Feb 2022pre-release

Nothing published for this version

2.7.23 Feb 2022

Fix issue with Locust completely shutting down on stop clicked in the web UI (a bug introduced in 2.7.1)

What's Changed

Reverse parts of PR #1992 by @cyberw in https://github.com/locustio/locust/pull/1996

Full Changelog: https://github.com/locustio/locust/compare/2.7.1...2.7.2

Open source →

Additional notes

Fix an issue introduced in 2.7.1 that caused Locust to shut down when the UI stop was clicked https://github.com/locustio/locust/pull/1996

Open source →

2.7.12 Feb 2022

fix --html report in web mode by @uddmorningsun in https://github.com/locustio/locust/pull/1992

What's Changed

fix --html report in web mode by @uddmorningsun in https://github.com/locustio/locust/pull/1992
Allow repeated runs of run_single_user by @cyberw in https://github.com/locustio/locust/pull/1993
Send a tweet whenever there is a new release (testing this is actually the main purpose of this release :)

Full Changelog: https://github.com/locustio/locust/compare/2.7.0...2.7.1

Open source →

Additional notes

fix --html report in web mode https://github.com/locustio/locust/pull/1992

Open source →

2.7.1.dev1031 Jan 2022pre-release

Nothing published for this version

2.7.029 Jan 2022

Add run_single_user and documentation on how to debug Users/locustfiles by @cyberw in https://github.com/locustio/locust/pull/1985

What's Changed

Add run_single_user and documentation on how to debug Users/locustfiles by @cyberw in https://github.com/locustio/locust/pull/1985
Fix "socket operation on non-socket" at shutdown, by reverting #1935 by @cyberw in https://github.com/locustio/locust/pull/1991

Small fixes/improvements:

Fixing issue #1961 with incorrect "All users spawned" log messages wh… by @EzR1d3r in https://github.com/locustio/locust/pull/1977
unit tests: add extra validations in integration tests by @cyberw in https://github.com/locustio/locust/pull/1990
Add 99%ile for Web UI by @FooQoo in https://github.com/locustio/locust/pull/1989
hardening Environment.shape_class for distinct usage by @uddmorningsun in https://github.com/locustio/locust/pull/1983

Full Changelog: https://github.com/locustio/locust/compare/2.6.1...2.7.0

Open source →

Additional notes

Add run_single_user and documentation on how to debug Users/locustfiles https://github.com/locustio/locust/pull/1985
Fix "socket operation on non-socket" at shutdown, by reverting #1935 https://github.com/locustio/locust/pull/1991
Fixing issue with incorrect "All users spawned" log messages https://github.com/locustio/locust/pull/1977

Open source →

2.6.2.dev2629 Jan 2022pre-release

Nothing published for this version

2.6.2.dev2129 Jan 2022pre-release

Nothing published for this version

2.6.2.dev1928 Jan 2022pre-release

Nothing published for this version

2.6.2.dev1728 Jan 2022pre-release

Nothing published for this version

2.6.2.dev1528 Jan 2022pre-release

Nothing published for this version

2.6.2.dev827 Jan 2022pre-release

Nothing published for this version

2.6.126 Jan 2022

Pretty much only documentation fixes

Full Changelog: https://github.com/locustio/locust/compare/2.6.0...2.6.1

Open source →

Additional notes

Documentation fixes only.

Open source →

2.6.1.dev824 Jan 2022pre-release

Nothing published for this version

2.6.1.dev624 Jan 2022pre-release

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →