Skip to content

CIROAI/CIRO

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

22 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CIRO Logo

CIRO

Crisis Intelligence & Response Orchestrator

Mobile-first agentic crisis response β€” signal fusion, severity prediction, resource allocation, and impact simulation in one command center.


Flutter Dart Groq Google Maps OpenWeather Platform Status License


πŸ† Google Antigravity Hackathon β€” Challenge 3: Crisis Intelligence & Response Orchestrator Built to demonstrate how agentic systems can move cities from reactive crisis response to coordinated situational intelligence.


Overview Β· Capabilities Β· Architecture Β· Stack Β· Setup Β· Demo Β· Roadmap


Overview

Cities rarely receive crisis information through a single clean channel. A flood surfaces first as a social post β€” then a weather alert β€” then a traffic disruption β€” while a field report contradicts the original signal entirely.

CIRO is built for that reality. It ingests fragmented multi-source signals, classifies emerging incidents, predicts severity, allocates constrained resources, simulates response outcomes, and explains every decision in a human-readable command center β€” designed for laypeople and responders, not just technical operators.


Core Capabilities

Capability Description
Multi-Signal Fusion Ingests social/citizen reports, weather, traffic, sensors, field reports, and emergency proxies
Crisis Classification Detects urban flooding, heatwave, accident, road blockage, power outage, and monitoring states
Severity Prediction Estimates severity, confidence, affected population, duration, spread risk, and peak impact
Resource Allocation Optimizes dispatch of ambulances, rescue teams, police, shelters, pumps, and generators
Impact Simulation Before/after metrics for response time, congestion, resource cost, and side effects
Stakeholder Messaging Tailored communications for public, emergency services, hospitals, utilities, and transport
False Signal Recovery Handles false positives, false negatives, stale APIs, and conflicting sources gracefully
Antigravity Traces Structured orchestration traces for full auditability and judge review

Architecture

Signal Layer              Agent Pipeline                 Output Layer
──────────────────        ───────────────────────        ──────────────────────────
Social / Citizens    β†’    Credibility Scoring       β†’    Command Center UI
Weather                   Crisis Classification          Crisis Detail View
Traffic / Routes          Severity Prediction            Response Plan
Mock Sensors              Resource Optimization          Impact Simulation
Field Reports             Stakeholder Messaging          Antigravity Traces
Emergency Proxies         False-Signal Recovery          Notification Inbox

Design Principles

  • Mock-first, real-ready β€” deterministic demos ship reliably; live signals layer on top
  • Typed pipeline outputs β€” every stage produces structured data, no ad hoc UI strings
  • Graceful degradation β€” missing APIs become labeled warnings, not crashes
  • Explainability by design β€” every agent decision has a plain-language counterpart

Technology Stack

App

Layer Technology
Framework Flutter β€” Mobile + Web
Language Dart ^3.10.8
Routing go_router
State Singleton services Β· ListenableBuilder
Storage shared_preferences Β· flutter_dotenv
Auth Google Sign-In Β· local profile persistence
Notifications flutter_local_notifications

AI & Data

Source Role
Groq API Β· llama-3.3-70b-versatile Crisis classification, response planning, simulation, stakeholder comms
Google Maps Β· google_maps_flutter Interactive maps, traffic-aware routing
OpenWeather Live weather risk β€” rainfall, heat, humidity, wind
NewsAPI Β· GNews Β· ReliefWeb Crisis-relevant public signal enrichment
X API Recent official-handle posts (NDMA, police, transport, highway authorities)

Demo Modes

Demo Mode β€” Primary judging path. Deterministic, fully offline, built around curated G-10 Islamabad scenarios. Use this for video recording and judge presentations. No API keys required.

Real Mode β€” Uses device GPS and live API signals. Gracefully degrades when keys are absent; every missing service becomes a labeled fallback rather than a failure. Groq enables the full AI agent pipeline; other APIs expand live signal coverage progressively.


Setup

Prerequisites: Flutter SDK (Dart ^3.10.8) Β· Chrome Β· Android Studio or Xcode

flutter pub get

Create .env in the project root:

GOOGLE_MAPS_API_KEY=your_key
OPENWEATHER_API_KEY=your_key
NEWS_API_KEY=your_key
GNEWS_API_KEY=your_key
GROQ_API_KEY=your_key
X_BEARER_TOKEN=your_token

All keys are optional. Demo Mode is fully functional with zero configuration.

# Development
flutter run -d chrome          # Web
flutter run -d android         # Android

# Production
flutter build web
flutter build apk --release

Testing

flutter analyze    # Static analysis
flutter test       # Unit & widget tests

Automated coverage includes: scenario initialization Β· all five verification states Β· multi-crisis coordination Β· resource trade-off generation Β· Antigravity trace output Β· degraded fallback baseline Β· Real Mode adapter conversion.


Demo Script

Step Action
1 Launch β†’ select Demo Mode: G-10 Islamabad
2 Command Center β€” active crisis, signal cards, map, crisis feed
3 Crisis Details β€” affected area, confidence, peak impact, people at risk
4 Tap Why? β€” plain-language source agreement and confidence explanation
5 Response Plan β€” tactical dispatch timeline and expected steps
6 Expected Impact β€” before/after simulated outcomes
7 Switch to simultaneous flood + heatwave β€” multi-crisis trade-offs
8 False positive recovery scenario β€” alert retraction and correction path
9 Note structured Antigravity trace events generated beneath the UI

Roadmap

  • Streaming adapters for social, weather, traffic, IoT sensors, and hospital capacity
  • Server-side resource optimization with agency-specific inventory and travel-time constraints
  • Immutable incident audit store for Antigravity traces
  • Operator approval queues for public alerts and alert retractions
  • Real GIS flood plains, road graphs, and urban vulnerability maps
  • Role-based access for field teams, hospitals, utilities, and command centers
  • Post-incident analytics and model calibration

Limitations

CIRO is a hackathon prototype β€” not a replacement for official emergency services. Emergency calls, sensors, and field report feeds are simulated unless connected to real city infrastructure. Public alerts require human approval before any production deployment. Antigravity traces are prototype orchestration artifacts, not certified incident-command records.



CIRO



CIRO

Detect. Decide. Respond.




Google

Antigravity Hackathon

Challenge 3 β€” Crisis Intelligence & Response Orchestrator


CIRO was built for the Google Antigravity Hackathon to demonstrate how agentic systems can help cities move from reactive crisis response to coordinated situational intelligence.


Google Antigravity Hackathon Challenge 3