Skip to main content

Job scheduling for humans.

Project description

sche is a fork of schedule – Python job scheduling for humans.

An in-process scheduler for periodic jobs that uses the builder pattern for configuration. Schedule lets you run Python functions (or any other callable) periodically at pre-determined intervals using a simple, human-friendly syntax.

Inspired by Adam Wiggins’ article “Rethinking Cron” and the clockwork Ruby module.


  • A simple to use API for scheduling jobs.
  • Very lightweight and no external dependencies.
  • Excellent test coverage.
  • Tested on Python 3.6+
  • Timezone support.


$ pip install sche
import sche
import time

def job():
    print("I'm working...")


# or use schedule expression
sche.when("every 10 minutes").do(job)
sche.when("every hour").do(job)
sche.when("every day at 10:30").do(job)
sche.when("every 5 to 10 minutes").do(job)
sche.when("every monday").do(job)
sche.when("every wednesday at 13:15").do(job)
sche.when("every minute at :17").do(job)

# or use decorator to register job(without arguments)
@sche.when("every 10 minutes")
def another_job():
    print("I'm working on another job...")

sche.clear()  # remove all jobs

# set job with timezone

sche.run_forever()  # blockingly

# OR
sche.run_forever_background()  # non-blockingly


sche’s documentation lives at

Please also check the FAQ there with common questions.


Daniel Bader - @dbader_org -

Distributed under the MIT license. See LICENSE.txt for more information.

Project details

Download files

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

Files for sche, version 1.0a5
Filename, size File type Python version Upload date Hashes
Filename, size sche-1.0a5-py2.py3-none-any.whl (11.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size sche-1.0a5.tar.gz (16.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page