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

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.1.1
File Size Uploaded Provenance Actions
pysportbot-0.1.1.tar.gz 76.0 kB Without provenance Details for pysportbot-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 124.8 kB

Release files / pysportbot-0.1.1.tar.gz

Download URL pysportbot-0.1.1.tar.gz
Size 76.0 kB
Tags Source
SHA-256 checksum
How to use checksums
bc7cc5401c10ee10650c763c7ace4c3313919f2b1aede78be2fc59baeffad74e
BLAKE2b-256 checksum
How to use checksums
b9c3b448163b448733e9d026c1d3fd2686ffea428b34ebe8d0ef1f8ec574e4e7
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.1-py3-none-any.whl

Download URL pysportbot-0.1.1-py3-none-any.whl
Size 48.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
60b4daeb0117f6fa830446a2c017415d22dcf6e8425a5d4bd3335d60c573c427
BLAKE2b-256 checksum
How to use checksums
83d1a0720f3622020ff4721776b17bbf0e5964b49a1cf747f2d6c8661e2e86a8
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.1

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