Guido.Tech/ai_intelligence_layer/QUICKSTART.md

🚀 Quick Start Guide - AI Intelligence Layer

⚡ 60-Second Setup

1. Get Gemini API Key

Visit: https://makersuite.google.com/app/apikey

2. Configure

cd ai_intelligence_layer
nano .env
# Add your API key: GEMINI_API_KEY=your_key_here

3. Run

source myenv/bin/activate
python main.py

Service starts on: http://localhost:9000

---

🧪 Quick Test

Health Check

curl http://localhost:9000/api/health

Full Test

./test_api.sh

---

📡 API Endpoints

Endpoint	Method	Purpose
/api/health	GET	Health check
/api/ingest/enriched	POST	Webhook receiver
/api/strategy/brainstorm	POST	Generate 20 strategies
/api/strategy/analyze	POST	Select top 3

---

🔗 Integration

With Enrichment Service (localhost:8000)

Option 1: Pull (AI fetches)

# In enrichment service, AI will auto-fetch from:
# http://localhost:8000/enriched?limit=10

Option 2: Push (Webhook - RECOMMENDED)

# In enrichment service .env:
NEXT_STAGE_CALLBACK_URL=http://localhost:9000/api/ingest/enriched

---

📦 What You Get

Input

• Enriched telemetry (aero, tires, ERS, fuel, consistency)
• Race context (track, position, competitors)

Output

• 20 diverse strategies (conservative → aggressive)
• Top 3 analyzed with:
  • Win probabilities
  • Risk assessment
  • Engineer briefs
  • Driver radio scripts
  • ECU commands

---

🎯 Example Usage

Brainstorm

curl -X POST http://localhost:9000/api/strategy/brainstorm \
  -H "Content-Type: application/json" \
  -d '{
    "race_context": {
      "race_info": {"track_name": "Monaco", "current_lap": 27, "total_laps": 58},
      "driver_state": {"driver_name": "Hamilton", "current_position": 4}
    }
  }'

Analyze

curl -X POST http://localhost:9000/api/strategy/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "race_context": {...},
    "strategies": [...]
  }'

---

🐛 Troubleshooting

Issue	Solution
API key error	Add GEMINI_API_KEY to .env
Enrichment unreachable	Start enrichment service or provide telemetry data
Import errors	Activate venv: source myenv/bin/activate

---

📚 Documentation

• Full docs: README.md
• Implementation details: IMPLEMENTATION_SUMMARY.md
• Sample data: sample_data/

---

✅ Status

All systems operational! Ready to generate race strategies! 🏎️💨