Skip to main content
Python Versions PyPI Package Actions Status ReadTheDocs Code style: black

RedBeat is a Celery Beat Scheduler that stores the scheduled tasks and runtime metadata in Redis.

Why RedBeat?

  1. Dynamic live task creation and modification, without lengthy downtime

  2. Externally manage tasks from any language with Redis bindings

  3. Shared data store; Beat isn’t tied to a single drive or machine

  4. Fast startup even with a large task count

  5. Prevent accidentally running multiple Beat servers

For more background on the genesis of RedBeat see this blog post

Getting Started

Install with pip:

pip install celery-redbeat

Configure RedBeat settings in your Celery configuration file:

redbeat_redis_url = "redis://localhost:6379/1"

Then specify the scheduler when running Celery Beat:

celery beat -A <celery_app_file_path>.<celery_app_instance_name> -S redbeat.RedBeatScheduler

If using the embedded beat in a worker process (like in development), specify the scheduler like so:

celery worker --beat --scheduler redbeat.RedBeatScheduler ...

RedBeat uses a distributed lock to prevent multiple instances running. To disable this feature, set:

redbeat_lock_key = None

More details available on Read the Docs

Development

RedBeat is available on GitHub

Once you have the source you can run the tests with make (recommended):

make setup
make test

Or using pip directly:

pip install -r requirements-dev.txt
python -m unittest discover tests

Optional: if you use mise to manage Python, it will read .mise.toml and install the pinned Python version. After that, still use make for tasks:

mise install
make setup && make test

You can also quickly fire up a sample Beat instance with:

celery beat --config exampleconf

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

celery_redbeat-2.4.2.tar.gz (36.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

celery_redbeat-2.4.2-py2.py3-none-any.whl (16.5 kB view details)

Uploaded Python 2Python 3

File details

Details for the file celery_redbeat-2.4.2.tar.gz.

File metadata

  • Download URL: celery_redbeat-2.4.2.tar.gz
  • Upload date:
  • Size: 36.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for celery_redbeat-2.4.2.tar.gz
Algorithm Hash digest
SHA256 a590fef7ef39d7e4511174ce8bafe310e07ef6cdf84a240cd311946815bd90bb
MD5 0c32642a2d7dc892315c47f53610a752
BLAKE2b-256 03139aefb6cb39266b28ab2b2a8f24382fd7d82399e20578c5ba2238e63c4445

See more details on using hashes here.

Provenance

The following attestation bundles were made for celery_redbeat-2.4.2.tar.gz:

Publisher: publish.yml on sibson/redbeat

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file celery_redbeat-2.4.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for celery_redbeat-2.4.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4124d221a798ad983df0874bfa0d2e9beca41ca9ef91e92d073770bb193da000
MD5 7e97215e9a462369f109e6cd790df4de
BLAKE2b-256 113dbb4adef34e7691ebd2e80c1e8df1fb3f3bf43b388de714219ac6a580a4d2

See more details on using hashes here.

Provenance

The following attestation bundles were made for celery_redbeat-2.4.2-py2.py3-none-any.whl:

Publisher: publish.yml on sibson/redbeat

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page