zerodb-apscheduler

APScheduler job store backed by ZeroDB. Persistent job scheduling with auto-provisioning -- no Redis, no database setup.

Why zerodb-apscheduler?

Installation

pip install zerodb-apscheduler

Quick Start

from apscheduler.schedulers.background import BackgroundScheduler
from zerodb_apscheduler import ZeroDBJobStore

def daily_report():
    print("Generating daily report...")

scheduler = BackgroundScheduler()
scheduler.add_jobstore(ZeroDBJobStore())  # auto-provisions ZeroDB
scheduler.add_job(daily_report, 'cron', hour=6)
scheduler.start()

That's it. Jobs persist across restarts with zero infrastructure.

How It Works

1. On first use, ZeroDBJobStore auto-provisions a free ZeroDB project
2. Jobs are serialized and stored in a ZeroDB NoSQL table (apscheduler_jobs)
3. get_due_jobs() queries by next_run_time for efficient scheduling
4. Credentials are saved to ~/.zerodb/config.json for future runs

Configuration

Explicit Credentials

store = ZeroDBJobStore(
    api_key="your-api-key",
    project_id="your-project-id",
)

Environment Variables

export ZERODB_API_KEY="your-api-key"
export ZERODB_PROJECT_ID="your-project-id"

Custom Table Name

store = ZeroDBJobStore(table_name="my_scheduler_jobs")

Credential Resolution Order

1. Constructor arguments (api_key, project_id)
2. Environment variables (ZERODB_API_KEY, ZERODB_PROJECT_ID)
3. Config file (~/.zerodb/config.json)
4. Auto-provision (free, no signup required)

APScheduler Compatibility

ZeroDBJobStore implements APScheduler's BaseJobStore interface:

Examples

Interval Scheduling

scheduler.add_job(check_health, 'interval', minutes=5)

Cron Scheduling

scheduler.add_job(weekly_cleanup, 'cron', day_of_week='sun', hour=3)

Multiple Job Stores

from apscheduler.jobstores.memory import MemoryJobStore

scheduler.add_jobstore(MemoryJobStore(), 'volatile')
scheduler.add_jobstore(ZeroDBJobStore(), 'persistent')

scheduler.add_job(temp_task, 'interval', seconds=10, jobstore='volatile')
scheduler.add_job(important_task, 'cron', hour=6, jobstore='persistent')

License

MIT

Powered by ZeroDB + AINative

ZeroDB is a serverless database with auto-provisioning, vector search, and NoSQL tables. Build AI-native apps without managing infrastructure.

• Documentation
• GitHub
• Discord