locust-cloud

library1.30.0pypypi✓ verified 24d ago

Locust Cloud is a Python library that acted as a client for the now-defunct Locust Cloud service, enabling users to deploy and manage distributed Locust load tests on a hosted cloud platform. The underlying Locust Cloud service has been shut down. The library's latest version is 1.30.0, and it follows the release cadence of its primary dependency, Locust, though its utility is now limited due to the service discontinuation.

devops testing http-networking aws workflow

pip install locust-cloud

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · LOCUST-CLOUD

locust-cloud

devopspythonv1.30.0

Install

5.5s avg

Import

715ms

Disk

39MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.30.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 6.3s

py 3.11

✓ —

✓ 5.65s

py 3.12

✓ —

✓ 4.9s

py 3.13

✓ —

✓ 4.95s

py 3.9

✕ build_error

39MB installed

● package 39MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ApiSession

✓ from locust_cloud import ApiSession

✗ from locust import HttpUser, task

This quickstart demonstrates a typical Locust test script (`my_locustfile.py`) that would have been used with the `locust-cloud` extension. The `locust-cloud` library extended the standard `locust` command with a `--cloud` flag to deploy these tests to the hosted service. Note the use of environment variables for non-interactive authentication for CI/CD scenarios.

# my_locustfile.py from locust import HttpUser, task, between class WebsiteUser(HttpUser): wait_time = between(1, 2) host = "http://127.0.0.1:8089" # Or a mock server provided by Locust Cloud @task def index_page(self): self.client.get("/") @task(3) def view_items(self): for item_id in range(10): self.client.get(f"/item?id={item_id}", name="/item") # To have run this with Locust Cloud (before its shutdown): # 1. Ensure you have Locust Cloud credentials configured (e.g., via `locust --cloud --login` or environment variables). # 2. Run your test: # LOCUSTCLOUD_USERNAME=os.environ.get('LOCUSTCLOUD_USERNAME', '') \ # LOCUSTCLOUD_PASSWORD=os.environ.get('LOCUSTCLOUD_PASSWORD', '') \ # LOCUSTCLOUD_REGION=os.environ.get('LOCUSTCLOUD_REGION', 'us-east-1') \ # locust --cloud -f my_locustfile.py --headless --users 10 --spawn-rate 1

Debug

Known issues

breakingThe Locust Cloud service, for which this library acts as a client, has been officially shut down. This means the primary functionality of `locust-cloud` (deploying and running tests on the hosted platform) is no longer operational.

fix

Migrate your load testing infrastructure to self-hosted open-source Locust, which continues to be actively developed and maintained. The core Locust project can be found at https://locust.io and installed via `pip install locust`.

affects: All versions

deprecatedThe `locust-cloud` library is deprecated due to the shutdown of its dependent service. No further development or support is expected for this client library.

fix

Discontinue use of `locust-cloud`. Focus on the core `locust` library for all new and existing load testing requirements.

affects: All versions

gotchaThis library acts as a command-line interface (CLI) extension to the main `locust` command. It does not provide Python modules for direct programmatic import into your test scripts beyond what the core `locust` library offers. Your `locustfile.py` should only import from `locust`.

fix

Always import `HttpUser`, `task`, `between`, etc., from the `locust` package in your test scripts. The `locust-cloud` functionality was invoked via `locust --cloud ...`.

affects: All versions

Upgrade

Version history

1.30.0latest on PyPI · released Dec 15, 2025

Audit

Dependencies

locustrequired`locust-cloud` is an extension for the Locust load testing framework. While not a direct PyPI dependency for `locust-cloud` itself, `locust` is required for defining and running actual load tests.

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/locustcloud/locust-cloud ↗

packagehttps://pypi.org/project/locust-cloud/ ↗

homepagehttps://locust.cloud ↗