egregore/schedule
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Task scheduler service
3 commits 1 branch 0 tags 57 KiB
Find a file
Exact
egregore 8873c4e377 Port schedule service from Python to Rust + Rouille 
- Background scheduler thread (30s interval)
- Cron expression parsing with cron crate
- File-based JSON storage (compatible with existing data)
- HTTP API: CRUD, manual run, history
- ~3MB binary vs ~50MB Python

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 20:29:59 +00:00
src Port schedule service from Python to Rust + Rouille 2026-02-02 20:29:59 +00:00
.gitignore Initial schedule service implementation 2026-02-02 12:52:19 +00:00
__init__.py Initial schedule service implementation 2026-02-02 12:52:19 +00:00
Cargo.lock Port schedule service from Python to Rust + Rouille 2026-02-02 20:29:59 +00:00
Cargo.toml Port schedule service from Python to Rust + Rouille 2026-02-02 20:29:59 +00:00
main.py Initial schedule service implementation 2026-02-02 12:52:19 +00:00
README.md Add README documentation 2026-02-02 19:58:25 +00:00
scheduler.py Initial schedule service implementation 2026-02-02 12:52:19 +00:00

README.md

Schedule Service

Task scheduler for Egregore.

Purpose

Cron-like scheduler that triggers AI tasks on a schedule. Wakes the reason service at configured times to perform automated work.

Endpoints

Endpoint Method Description
/schedules GET/POST List or create schedules
/schedules/{id} GET/PATCH/DELETE Manage a schedule
/schedules/{id}/run POST Manually trigger a schedule
/schedules/{id}/history GET View execution history
/health GET Health check

Configuration

Schedules stored in ~/data/schedules/.

Each schedule has:

  • name - Descriptive name
  • cron - Cron expression (e.g., 0 9 * * *)
  • instruction - What to tell the reason service
  • enabled - Active flag

Running

# Activate venv
source ~/.venv/bin/activate

# Run directly
python main.py

# Or via systemd
sudo systemctl start schedule
sudo systemctl status schedule

Cron Format

Standard 5-field cron: minute hour day month weekday

Examples:

  • 0 9 * * * - Daily at 9am
  • */15 * * * * - Every 15 minutes
  • 0 0 * * 0 - Weekly on Sunday midnight

Dependencies

  • FastAPI
  • APScheduler (cron scheduling)
  • httpx (to call reason service)