Skip to content

NevineAKF/OlympusOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

21 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›๏ธ OlympusOS โ€” Cognitive Urban Operating System

A multi-agent AI orchestration platform for real-time crowd intelligence, crisis prediction, and autonomous coordination at mega-scale urban events.

Python FastAPI CesiumJS CrewAI Vultr License

๐Ÿ”ด LIVE DEMO โ†’ http://olympusos.ddns.net

Built for Milano Cortina 2026 โ€” Winter Olympics AI Hackathon


๐Ÿง  What Is OlympusOS?

OlympusOS is a cognitive operating system for cities โ€” an AI orchestration platform built to solve one of the most underestimated risks in modern urban infrastructure: the systemic failure of human coordination during high-density events.

Traditional monitoring systems are passive. They display data. They do not reason across it, issue coordinated decisions, or adapt in real time to cascading crises. When 80,000 people exit a stadium simultaneously and the metro system fails, the gap between a dashboard and intelligence becomes a matter of public safety.

OlympusOS replaces that gap with seven specialized AI agents that perceive anomalies, forecast trajectories, deliberate on interventions, and execute coordinated responses โ€” autonomously, in under 60 seconds.

Designed for Milano Cortina 2026, it represents a new category of urban infrastructure: Cognitive Urban Intelligence.


๐ŸŽฌ Live Demo

โ†’ http://olympusos.ddns.net

No login required. Click โ–ถ RUN DEMO to launch the full 90-second cinematic crisis scenario over a photorealistic 3D rendering of San Siro Stadium, Milan. Watch seven AI agents detect a crowd crush in real time, deliberate, and resolve the incident โ€” no injuries, response time 47 seconds.


โš ๏ธ Important Context โ€” Beyond the Olympics

OlympusOS was demonstrated using the Milano Cortina 2026 Winter Olympics as a scenario โ€” not because it is limited to Olympic events, but because a mega-event represents the ultimate stress test for urban intelligence systems.

The real scope of OlympusOS is much broader:

  • ๐Ÿ™๏ธ Smart city management โ€” continuous AI coordination of urban systems
  • ๐Ÿšจ Crisis management โ€” autonomous response to any large-scale emergency
  • โšก Energy optimization โ€” intelligent load balancing during peak demand
  • ๐Ÿšฆ Traffic & mobility โ€” city-wide flow optimization in real time
  • ๐ŸŒŠ Disaster response โ€” coordinated multi-agency AI orchestration
  • ๐Ÿฅ Public health emergencies โ€” resource allocation and communication
  • ๐ŸŽญ Any high-density event โ€” concerts, political summits, festivals

The Olympics scenario was chosen because it is immediate (Milano Cortina 2026 launches in months), globally recognized, and operationally extreme. It is the perfect proof-of-concept for a system designed to scale to any urban challenge.


โšก The Problem

Large-scale events expose fundamental fragility in urban systems:

  • ๐Ÿ“ก Fragmented monitoring โ€” no single operator sees the full picture
  • โฑ๏ธ Reactive coordination โ€” response arrives minutes after critical thresholds breach
  • ๐Ÿ”— Communication bottlenecks โ€” transport, security, medical, and comms agencies operate in silos
  • ๐Ÿ“Š Dashboard paralysis โ€” operators see data but receive no synthesis, prediction, or decision support
  • ๐ŸŒŠ Cascade failure โ€” one blocked gate triggers metro overcrowding triggers ambulance gridlock

The 2022 Itaewon crowd crush (158 deaths), the 2010 Love Parade disaster (21 deaths), and dozens of stadium incidents share a common thread: the information existed. The intelligence did not.


๐Ÿค– The Seven Agents

OlympusOS deploys a coordinated team of seven specialized AI agents, each with a defined cognitive role:

Emoji Agent Role Model
๐Ÿ‘๏ธ Perception Real-time crowd density monitoring, camera anomaly detection DeepSeek-V3.1
๐Ÿ”ฎ Forecast Predictive crush trajectory modeling, risk scoring DeepSeek-V3.1
๐Ÿšฆ Mobility Evacuation corridor planning, route optimization Qwen2.5-7B-Instruct
๐ŸšŒ Transit Bus and transport fleet coordination Qwen2.5-7B-Instruct
๐Ÿ›ก๏ธ Safety Medical team dispatch, ambulance routing Mistral-Nemo-Instruct-2407
๐Ÿ“ข Communications Bilingual public alerts (EN/IT), stadium broadcast Mistral-Nemo-Instruct-2407
๐Ÿง  Orchestrator Command authority โ€” synthesizes agent inputs, issues binding decisions DeepSeek-V3.1

Agents communicate through a CrewAI pipeline with causal pacing: detection โ†’ forecast โ†’ deliberation โ†’ authorization โ†’ execution. The Orchestrator holds veto and override authority over all agents.


โœ… Feature Matrix

Feature Status Description
7-Agent CrewAI Pipeline โœ… Implemented Real-time multi-agent orchestration at 10Hz
FastAPI WebSocket Backend โœ… Implemented Async streaming server, persistent connections
Google Photorealistic 3D Tiles โœ… Implemented Real San Siro Stadium โ€” textured 3D buildings
90s Cinematic Scenario Engine โœ… Implemented JSON-driven, 51 events across 4 dramatic acts
Live Agent Chat Feed โœ… Implemented WhatsApp-style panel with colored agent identities
Crowd Dot Simulation โœ… Implemented 80 entities, density-based orangeโ†’red color transitions
Bus Fleet Animation โœ… Implemented 30 buses routed depot โ†’ north gate over 25 seconds
Ambulance Dispatch โœ… Implemented Flashing position animation with live routing
Metro M5 Failure Event โœ… Implemented Flashing red polyline on service suspension
Evacuation Corridor โœ… Implemented Dual-layer green glow polyline along Corridor B
Speechmatics Transcript โœ… Implemented Live word-by-word emergency broadcast stream
Metrics HUD โœ… Implemented Crowd Risk / Evacuation / Response / Buses
Camera Flythrough System โœ… Implemented 8 cinematic camera positions, cubic easing
Vultr Cloud Deployment โœ… Implemented nginx reverse proxy + systemd process supervision
SUMO Traffic Simulation ๐Ÿ”ถ Mocked Architecture exists, data generated from simulation
Real CCTV Ingestion ๐Ÿ”ฒ Designed YOLO object detection pipeline โ€” not yet wired
IoT Sensor Grid ๐Ÿ”ฒ Designed Pressure sensor API integration conceptualized
RL Policy Optimization ๐Ÿ”ฒ Designed Reinforcement learning layer for route decisions

๐Ÿ—๏ธ Architecture

                        OlympusOS โ€” Cognitive Layer
                        ===========================

  [Perception]   [Forecast]   [Mobility]   [Transit]
       |               |            |            |
  [Safety]       [Communications]  |            |
       |               |            |            |
       +---------------+------------+------------+
                                |
                         [Orchestrator]
                         Command Core
                                |
       +------------------------+------------------------+
       |                        |                        |
  [CesiumJS]            [FastAPI Backend]         [Speechmatics]
  3D Digital Twin       WebSocket / REST          Live Transcript
  Google 3D Tiles       CrewAI Pipeline           Audio Analysis
       |                        |                        |
       +------------------------+------------------------+
                                |
                     [Vultr Ubuntu 24.04]
                     nginx --> systemd
                     http://olympusos.ddns.net

๐Ÿ”„ Crisis Response Flow

  DETECT (0-12s)
  Perception detects density spike at Gate 4
       --> Camera 7 confirms visual bottleneck
       --> Forecast models 6.4 ppl/m2 in 3:40

  DELIBERATE (12-30s)
  Mobility identifies Corridor B as clear
       --> Safety stages medical teams
       --> Transit holds 30 buses at Lampugnano
       --> Orchestrator: AUTHORIZE

  EXECUTE (30-66s)
  Corridor B opens  -->  Gate 4 outflow redirects
  30 buses deploy   -->  M5 fails, buses become critical
  Ambulances roll   -->  Comms pushes bilingual alert

  RESOLVE (66-90s)
  Density: 6.4 --> 2.6 ppl/m2
  Risk: 0.83 --> 0.28
  Response window: 47 seconds. No injuries.

๐Ÿ› ๏ธ Technology Stack

๐Ÿ–ฅ๏ธ Frontend

Technology Version Purpose
CesiumJS 1.114 3D geospatial rendering engine
Google Maps Platform โ€” Photorealistic 3D Tiles (Map Tiles API)
HTML5 / CSS3 / JavaScript ES2022 Single-file SPA, zero build step
Web Audio API โ€” Soft bell notifications per agent event
WebSocket API โ€” Real-time backend event streaming

โš™๏ธ Backend

Technology Version Purpose
Python 3.11 Runtime
FastAPI 0.104 Async REST + WebSocket server
CrewAI Latest Multi-agent orchestration framework
uvicorn Latest ASGI server
Speechmatics SDK Latest Real-time audio transcription
SUMO 1.18 Traffic simulation engine

๐Ÿค– AI Models (via Featherless.ai)

Model Agents
DeepSeek-V3.1 ๐Ÿง  Orchestrator, ๐Ÿ”ฎ Forecast, ๐Ÿ‘๏ธ Perception
Mistral-Nemo-Instruct-2407 ๐Ÿ›ก๏ธ Safety, ๐Ÿ“ข Communications
Qwen2.5-7B-Instruct ๐Ÿšฆ Mobility, ๐ŸšŒ Transit

โ˜๏ธ Infrastructure

Component Detail
Cloud Provider Vultr โ€” Ubuntu 24.04 VPS
Reverse Proxy nginx
Process Manager systemd
Version Control GitHub

๐Ÿš€ Installation & Deployment

Prerequisites

Python 3.11+
SUMO 1.18        # sudo apt install sumo
nginx
git

1. Clone

git clone https://github.com/NevineAKF/OlympusOS
cd OlympusOS

2. Configure Environment

cp .env.example .env
GOOGLE_MAPS_API_KEY=your_google_maps_platform_key
CESIUM_ION_TOKEN=your_cesium_ion_token
SPEECHMATICS_API_KEY=your_speechmatics_key
FEATHERLESS_API_KEY=your_featherless_key
GEMINI_API_KEY=your_gemini_key

3. Install Backend

pip install -r requirements.txt

4. Run Backend

uvicorn backend.main:app --host 0.0.0.0 --port 8000

5. Configure nginx

server {
    listen 80;

    location / {
        root /var/www/olympusos/dashboard;
        index index.html;
    }

    location /ws {
        proxy_pass http://localhost:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
    }

    location /run_demo {
        proxy_pass http://localhost:8000;
    }
}

6. Inject API Keys into Frontend

KEY=$(grep -oP 'GOOGLE_MAPS_API_KEY\s*=\s*\K\S+' .env)
ION=$(grep -oP 'CESIUM_ION_TOKEN\s*=\s*\K\S+' .env)
sed -i "s|__GOOGLE_MAPS_API_KEY__|${KEY}|g; s|__CESIUM_ION_TOKEN__|${ION}|g" dashboard/index.html

7. Access

Navigate to http://your-server-ip/ and click โ–ถ RUN DEMO.


๐Ÿ—บ๏ธ Roadmap

๐Ÿ“ Phase 1 โ€” Live Sensor Integration (0โ€“6 months)

  • ๐ŸŽฅ CCTV ingestion with real-time YOLO crowd density detection
  • ๐Ÿ“ก IoT pressure sensor grid at stadium gates
  • ๐Ÿš— Live SUMO traffic simulation with real road state feeds
  • ๐Ÿ—บ๏ธ Dynamic map overlays from real sensor data

๐Ÿ“ Phase 2 โ€” AI Capability Expansion (6โ€“12 months)

  • ๐Ÿงฌ Reinforcement learning policy optimization for crowd routing
  • ๐Ÿ—‚๏ธ Vector database agent memory โ€” persistent reasoning across events
  • ๐ŸŒ Multilingual command interface (Italian, English, French, German)
  • ๐Ÿš Drone coordination API for aerial crowd monitoring
  • ๐Ÿ“ˆ Predictive modeling with 10-minute lookahead horizons

๐Ÿ“ Phase 3 โ€” Municipal Deployment (12โ€“24 months)

  • ๐Ÿš” Integration with Italian police dispatch systems
  • ๐Ÿš‘ Real-time ambulance and fire brigade coordination API
  • ๐Ÿšฆ Smart traffic signal control interface
  • ๐Ÿ›ฐ๏ธ Satellite crowd density feeds for stadium perimeter
  • ๐Ÿ›๏ธ Government compliance and audit logging layer

๐Ÿ“ Phase 4 โ€” National Scale (2โ€“5 years)

  • ๐ŸŒ Multi-city deployment framework
  • ๐Ÿค– Autonomous emergency coordination โ€” zero human approval latency
  • ๐Ÿ™๏ธ Digital twin integration for full urban system modeling
  • ๐Ÿ… Government API for Olympics, World Cup, and G7-scale events
  • ๐Ÿ“Š Federated learning across event venues globally

โš ๏ธ Prototype Limitations

This is a proof-of-concept built by a solo developer over 3 days:

Constraint Detail
๐Ÿ‘ค Solo development Single developer, 72-hour build window
๐Ÿ’ป No GPU inference All LLM calls routed through external API
๐Ÿ“ก No live sensors Crowd simulation is mathematical, not camera-derived
๐Ÿ”’ No institutional APIs Police, medical, and transport systems unavailable
๐Ÿ’ฐ Infrastructure budget $200 Vultr credit, $890 Google Maps credit
โšก API rate limits Speechmatics, Google Maps, Featherless quotas

The architecture demonstrates systems-level thinking for a platform that, at full scale, would require dedicated engineering teams, institutional partnerships, and government-grade infrastructure.


๐Ÿ™ Acknowledgements

Project Role
Milano Cortina 2026 Inspiration and hackathon context
Cesium Open-source 3D geospatial rendering engine
Google Maps Platform Photorealistic 3D Tiles
CrewAI Multi-agent orchestration framework
Speechmatics Real-time audio transcription
SUMO Open-source traffic simulation
Featherless.ai LLM inference API

๐ŸŒ Vision

Cities are the most complex adaptive systems humanity has ever built. And yet, when they fail โ€” when 80,000 people try to leave a stadium at once, when a metro line drops, when a bottleneck turns into a crush โ€” the systems designed to protect people are still running on radio calls, spreadsheets, and fragmented dashboards.

OlympusOS is the answer to that gap.

Not a smarter dashboard. Not a better alert system. A cognitive layer โ€” a system that sees, reasons, decides, and acts. One that treats a city's real-time sensor data as a language and speaks back in coordinated action. One that compresses a 20-minute human coordination cycle into 47 seconds of autonomous intervention.

The prototype proves the architecture. The crisis at San Siro โ€” 6.4 people per square metre, children near the railings, a metro line down, 47,000 app notifications pushed in the same second โ€” all of it resolved, no injuries, under a minute.

This is what it looks like when cities stop reacting and start thinking.

OlympusOS. Cities that think.


Built for Milano Cortina 2026 โ€” Winter Olympics AI Hackathon

๐Ÿ”ด http://olympusos.ddns.net โ€” Live Demo

GitHub

About

Autonomous AI agents managing urban operations during mass-scale events

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors