How jangles-byte/pythia works
PYTHIA combines Osiris live intelligence feeds with a local forecasting engine and a globe-oriented interface. The principal flow is live signals into normalized events and a world brief, then oracle forecasts, optional council deliberation, and API/UI delivery. The README also documents alerts, the scheduled Morning Brief, markets, health scoring, and many feed integrations. Some routes and UI components are represented by their exact paths but were not sampled; their internal wiring is therefore not asserted.
Main entry points: pipeline.py Oracle pass · loop.py Scheduled loop · server.py Engine API · osiris_intake.py Event intake
Components 30
Live intelligence
- Feed API routes
integrations/osiris/routes - Camera API
integrations/osiris/routes/cams-route.ts - Markets and odds
integrations/osiris/routes/quotes-route.ts
Forecast engine
- Event intake
engine/osiris_intake.py - World brief
engine/world_state.py - Oracle pass
engine/pipeline.py - LLM oracle
engine/oracle.py - Council deliberation
engine/swarm.py - Domain models
engine/models.py - Live engine state
engine/state.py
Oracle services
- Forecast ledger
engine/ledger.py - Engine API
engine/server.py - Scheduled loop
engine/loop.py - Signal rules
engine/alerts.py - Webhook delivery
engine/webhooks.py - Morning Brief
engine/brief.py - Global Health Score
engine/healthscore.py - Ticker watch
engine/tickers.py
Osiris interface
- Forecast panel
integrations/osiris/PythiaPanel.tsx - Council view
integrations/osiris/DeliberationModal.tsx - Nearby cameras
integrations/osiris/CamsNearby.tsx - Brief panel
integrations/osiris/BriefPanel.tsx - Live alerts
integrations/osiris/LiveAlerts.tsx - Markets panel
integrations/osiris/MarketsPanel.tsx - Forecast calendar
integrations/osiris/ForecastCalendar.tsx - Forecast scorecard
integrations/osiris/ScorecardPanel.tsx - What-if panel
integrations/osiris/WhatIfPanel.tsx - TV kiosk
integrations/osiris/tv-page.tsx
Other components
- Operator or agent
- Osiris feeds
Connections 36
- Operator or agent → Forecast panel: requests forecasts
- Osiris feeds → Feed API routes: serves live feeds
- Feed API routes → Event intake: provides event data
engine/osiris_intake.py - Event intake → Oracle pass: fetches events
engine/pipeline.py - Oracle pass → World brief: builds brief
engine/pipeline.py - Oracle pass → Live engine state: publishes world
engine/pipeline.py - Oracle pass → LLM oracle: requests forecasts
- Oracle pass → Council deliberation: deliberates forecasts
engine/pipeline.py - Council deliberation → LLM oracle: queries personas
engine/swarm.py - Council deliberation → Forecast ledger: reads track record
engine/swarm.py - Oracle pass → Webhook delivery: fires event hooks
engine/pipeline.py - Engine API → Scheduled loop: starts loop
engine/server.py - Scheduled loop → Oracle pass: runs oracle pass
engine/loop.py - Engine API → Live engine state: serves snapshots
engine/server.py - Oracle pass → Forecast ledger: records briefs
engine/pipeline.py - Live engine state → Domain models: stores domain data
engine/state.py - Event intake → Domain models: normalizes events
engine/osiris_intake.py - Signal rules → Webhook delivery: pushes fired alerts
engine/alerts.py - Scheduled loop → Signal rules: evaluates rules
engine/loop.py - Scheduled loop → Morning Brief: schedules digest
engine/loop.py - Morning Brief → Forecast ledger: reads forecasts
engine/brief.py - Global Health Score → Live engine state: reads world state
engine/healthscore.py - Operator or agent → Engine API: queries engine
- Engine API → Forecast panel: returns forecasts
- Forecast panel → Council view: opens deliberation
integrations/osiris/PythiaPanel.tsx - Forecast panel → Brief panel: shows digest
integrations/osiris/PythiaPanel.tsx - Operator or agent → Nearby cameras: opens nearby cameras
- Operator or agent → Live alerts: configures signals
- Operator or agent → Markets panel: views markets
- Operator or agent → Forecast calendar: views forecast dates
- Operator or agent → Forecast scorecard: reviews performance
- Operator or agent → What-if panel: explores scenarios
- Operator or agent → TV kiosk: opens kiosk
- Camera API → Nearby cameras: serves camera data
- Markets and odds → Markets panel: serves quotes
- Feed API routes → Event intake: supplies world signals