No queues. Just gains.
pysportbot books fitness classes at sports centres that use the Resasports booking software. You can use it from the command line or from Python, or let it book your weekly classes as soon as bookings open, e.g. from a scheduled GitHub Actions workflow. It can also send you the result on your phone.
Installation
pip install pysportbot
pysportbot needs Python 3.11 or newer. With uv, uvx pysportbot runs the command without installing anything.
Quick start
Command line
# Find the slug of your centre (no login needed)
pysportbot centres --search madrid
# Tell pysportbot who you are; you are prompted for your password unless SPORTBOT_PASSWORD is set
export SPORTBOT_EMAIL="you@example.com"
export SPORTBOT_CENTRE="your-centre-slug"
# See what's on, then book
pysportbot activities
pysportbot slots Yoga monday
pysportbot book Yoga "2026-01-12 18:00"
Python
from pysportbot import SportBot
bot = SportBot()
bot.login("you@example.com", "your-password", "your-centre-slug")
for slot in bot.daily_slots("Yoga", "2026-01-12"):
print(slot.start, f"{slot.inscribed}/{slot.capacity}")
bot.book("Yoga", "2026-01-12 18:00")
Book every week, automatically
Describe your classes in a config.json:
{
"booking_execution": "Friday 07:30",
"classes": [
{"activity": "Yoga", "class_day": "Monday", "class_time": "18:00"}
]
}
Then start the booking service, e.g. every Friday from GitHub Actions:
pysportbot run --config config.json
It waits until Friday 07:30 and then books Yoga on the following Monday at 18:00. If the booking window has not opened yet, it keeps trying for up to a minute. It exits with code 1 if a class could not be booked.
Documentation
The full documentation is at jbeirer.github.io/resasports-bot:
- Command line: all commands, exit codes and env vars
- Python library: booking from your own code, error handling and logging
- Booking service: the config file and how bookings are retried
- Notifications: booking results on your phone with ntfy
- GitHub Actions: weekly bookings without a server
- API reference
Contributing
Contributions are welcome. See CONTRIBUTING.rst to set up a development environment.
License
pysportbot is open source and published under the MIT License.
Metadata
Release files for pysportbot 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pysportbot-0.1.0.tar.gz | 75.9 kB | Without provenance | Details for pysportbot-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pysportbot-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for pysportbot-0.1.0-py3-none-any.whl |
Total release size: 124.6 kB
Release files / pysportbot-0.1.0.tar.gz
| Download URL | pysportbot-0.1.0.tar.gz |
|---|---|
| Size | 75.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8fe6fd21effa8d3af054e39e20c8abe5a13565e603bb25c5cc0769e548ff0679
|
|
BLAKE2b-256 checksum How to use checksums |
561b01bc32bff2915d3c3306ca7ef56735fdff4f857dc5b7c41781b7484b3a5c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / pysportbot-0.1.0-py3-none-any.whl
| Download URL | pysportbot-0.1.0-py3-none-any.whl |
|---|---|
| Size | 48.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2a5dc701b8580e5933a30119f53636502c450b658fc6b2ed3f8655a541030f85
|
|
BLAKE2b-256 checksum How to use checksums |
b4668e5520a2deff057e100f667a3d3f3d36dc23e5e6c45f89b90d4b15851d83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for pysportbot 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.