Skip to main content
pysportbot logo

No queues. Just gains.

Documentation · PyPI · Releases

Release Build status codecov Activity License Documentation Contributor Covenant Downloads

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:

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

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pysportbot 0.2.0
File Size Uploaded Provenance Actions
pysportbot-0.2.0.tar.gz 81.3 kB Without provenance Details for pysportbot-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pysportbot 0.2.0
File Interpreter ABI Platform Actions
pysportbot-0.2.0-py3-none-any.whl Python 3 none any Details for pysportbot-0.2.0-py3-none-any.whl

Total release size: 132.8 kB

Release files / pysportbot-0.2.0.tar.gz

Download URL pysportbot-0.2.0.tar.gz
Size 81.3 kB
Tags Source
SHA-256 checksum
How to use checksums
533a2e9e5b98d0029baa145383f0d9ce7c534989774b471abeaaf139fa642e8f
BLAKE2b-256 checksum
How to use checksums
a71a9b5f295dc72fb3331ed1c92bdac5af01ab01200ff9cdc281ddd1ba955426
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / pysportbot-0.2.0-py3-none-any.whl

Download URL pysportbot-0.2.0-py3-none-any.whl
Size 51.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f311009b24c449749b06234849a4c38b9fc4b7f3b08ca60ecd3d3a55ce2e0b5
BLAKE2b-256 checksum
How to use checksums
e6dbebdac121e2ea5330ae0ef06b59520a6d25d685b8c3c1a94300a876f39e42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for pysportbot 0.2.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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page