How zazencodes/koyomi works
Koyomi is a small distributed job scheduler implemented in one Python module. Users manage jobs through the CLI or terminal dashboard; host schedulers ask the hub for due work, execute jobs locally, and report results and logs. The hub keeps job, run, host, and alert state as JSON. The README documents SSH-based remote access, catch-up behavior, service operation, and email alerts; the sampled source is partial, so internal call paths beyond those documented are not asserted.
Main entry points: koyomi.py Hub RPC
Components 16
User interfaces
- CLI commands
koyomi.py - Terminal dashboard
koyomi.py
Scheduling and coordination
- Hub RPC
koyomi.py - SSH transport
- Host scheduler
koyomi.py - Schedule and catch-up
koyomi.py - Job management
koyomi.py
Execution and results
- Job runner
koyomi.py - Output streaming
koyomi.py - Run logs and history
koyomi.py
State and alerts
- Hub JSON state
koyomi.py - Host heartbeats
koyomi.py - Alert handling
koyomi.py
Other components
- Operator
- Email service
- OS service manager
Connections 21
- Operator → CLI commands: runs commands
README.md - Operator → Terminal dashboard: opens dashboard
README.md - CLI commands → Hub RPC: requests actions
README.md - Terminal dashboard → Hub RPC: reloads and controls
README.md - Hub RPC → SSH transport: uses for remote hub
README.md - SSH transport → Hub RPC: routes to hub
README.md - Host scheduler → Hub RPC: requests due runs
README.md - Host scheduler → Schedule and catch-up: checks due slots
koyomi.py - Hub RPC → Job management: dispatches job actions
koyomi.py - Job management → Hub JSON state: updates job state
koyomi.py - Host scheduler → Job runner: runs due jobs
README.md - Job runner → Output streaming: streams output
README.md - Output streaming → Run logs and history: uploads run output
README.md - Host scheduler → Hub RPC: reports results
README.md - Hub RPC → Hub JSON state: stores run records
README.md - Hub RPC → Host heartbeats: records host reports
koyomi.py - Host scheduler → Alert handling: reports failures
koyomi.py - Alert handling → Email service: sends alerts
README.md - OS service manager → Host scheduler: starts scheduler
README.md - CLI commands → Run logs and history: shows run logs
README.md - Terminal dashboard → Run logs and history: views run logs
README.md