Skip to content

manavrenjith/yellowflag

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🟨 Yellow Flag

AI-Powered Racing Safety Intelligence

Yellow Flag Banner

Predict circuit risk before incidents occur.
Real-time AI-powered safety intelligence for motorsport officials.


⚠️ Important Disclaimer

Yellow Flag is a demonstration project created for the IBM AI Builders Hackathon.

The platform showcases how AI can assist motorsport safety operations using weather intelligence, historical incident analysis, and predictive risk assessment.

Data, predictions, recommendations, and risk scores shown within the demo may be incomplete, simulated, inaccurate, or unsuitable for real-world race control decisions.

This project should be considered a proof of concept and not an operational safety system.


🏁 What is Yellow Flag?

Yellow Flag is an AI-powered motorsport safety platform designed to help race directors, stewards, and circuit officials identify elevated risk conditions before incidents occur.

Instead of reacting to crashes after they happen, Yellow Flag continuously combines:

  • 🌦️ Live weather telemetry
  • 📄 Historical incident reports
  • 🏎️ Circuit-specific risk patterns
  • 🤖 AI reasoning and recommendations

to generate real-time safety intelligence across an entire race circuit.

Every corner receives its own continuously updated risk score, allowing officials to understand exactly where, why, and when danger is increasing.


✨ Key Features

🗺️ Circuit Risk Heatmap

Visualise the entire circuit with real-time risk scoring.

Highlights

  • Green / Yellow / Red risk indicators
  • Corner-by-corner analysis
  • Historical incident concentration
  • Weather contribution breakdown
  • AI-generated safety assessment

Officials can instantly identify hotspots requiring attention.


📈 Risk Timeline

Understand how circuit risk evolves throughout a race weekend.

Track projected risk across:

  • Practice Sessions
  • Qualifying
  • Race Day

This allows proactive planning and strategic deployment of safety resources before conditions deteriorate.


🌦️ Weather Intelligence

Live weather telemetry feeds directly into the risk engine.

Factors include:

  • Rain Probability
  • Wind Speed
  • Visibility
  • Temperature
  • Weather Trends

Weather conditions are evaluated at a corner level rather than as a circuit-wide average.


📄 Incident Intelligence

Historical motorsport incident reports are transformed into structured safety data using IBM Docling.

Yellow Flag identifies:

  • High-risk corners
  • Frequent incident zones
  • Condition-specific accident patterns
  • Historical severity trends

This provides context beyond what current weather alone can explain.


🤖 AI Safety Recommendations

Powered by IBM Granite.

The AI reasons across:

  • Current weather
  • Historical incidents
  • Circuit characteristics
  • Existing risk scores

to generate:

  • Actionable recommendations
  • Confidence scores
  • Prioritised alerts
  • Safety justifications

The goal is explainable AI rather than black-box predictions.


🔮 What-If Simulation

Prepare for changing conditions before they happen.

Officials can adjust:

  • Rain probability
  • Wind speed
  • Visibility
  • Temperature

and immediately see how risk changes across every corner.

Perfect for scenario planning and pre-session safety briefings.


🧠 How It Works

Weather API
      │
      ▼

Risk Engine ───────────────┐
                           │
Historical Reports         │
(IBM Docling)              │
      │                    ▼
      └──────────► IBM Granite
                         │
                         ▼

                 AI Recommendations
                         │
                         ▼

             Real-Time Safety Dashboard

🛠️ Technology Stack

Backend

  • Python
  • FastAPI

Frontend

  • Next.js
  • React
  • Tailwind CSS

AI & Intelligence

  • IBM Granite (via Ollama)
  • IBM Docling

Data Sources

  • WeatherAPI

🎯 Use Cases

Race Directors

Monitor evolving circuit risk and receive AI-backed safety guidance.

Safety Stewards

Understand incident-prone locations and prepare interventions proactively.

Circuit Operations Teams

Allocate marshals, recovery vehicles, and resources more effectively.

Motorsport Organisers

Improve situational awareness during changing weather conditions.


🚀 Vision

Motorsport safety systems traditionally react to incidents.

Yellow Flag aims to shift the paradigm toward:

Predict → Prepare → Prevent

By combining operational data, historical intelligence, and explainable AI, race officials gain a clearer understanding of emerging risks before they become incidents.

About

Real-time AI-powered racing safety platform that predicts circuit risk using weather data, historical incidents, and IBM Granite AI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors