cronify

Lightweight background task scheduler for Python — no Celery needed

Install

pip install cronify

Usage

from cronify import Scheduler

scheduler = Scheduler()

@scheduler.every(minutes=5)
async def cleanup_expired_tokens():
    await db.execute("DELETE FROM tokens WHERE expires_at < now()")

@scheduler.every(hours=1, run_immediately=True)
async def sync_exchange_rates():
    rates = await fetch_rates()
    await cache.set("rates", rates)

# Start in your FastAPI app:
@app.on_event("startup")
async def startup():
    await scheduler.start()

Features

• @scheduler.every(seconds=30) — decorator syntax
• Async and sync functions supported
• Error resilient — one failing job doesn't stop others
• No Redis, no Celery, no external broker
• Pure asyncio — works everywhere Python runs
• run_immediately=True for instant first execution
• Zero dependencies

API

scheduler.every(seconds=30)            # every 30 seconds
scheduler.every(minutes=5)             # every 5 minutes
scheduler.every(hours=1)               # every hour
scheduler.every(hours=1, minutes=30)   # every 1.5 hours
scheduler.every(seconds=10, run_immediately=True)  # run now, then every 10s

await scheduler.start()   # start all jobs
await scheduler.stop()    # cancel all jobs
scheduler.jobs             # list registered jobs

License

MIT