🚀 NeuroDrive
AI-Powered Vehicle Intelligence Platform
Real-time OBD-II monitoring with AI diagnostics. Monitor your car's health, get instant explanations for check engine codes, and track driving patterns—all in a beautiful, modern dashboard.
- Live Dashboard - 6 KPI cards updating every second
- WebSocket Streaming - Real-time engine data via Socket.IO
- Historical Data - SQLite database storing every reading
- Realistic Simulation - Test without a car using driving simulator
- Plain English Explanations - AI translates technical codes into simple language
- Cost Estimates - Get repair cost ranges ($400-$1,200)
- Safety Advice - Know if it's safe to keep driving
- Urgency Levels - Understand when to fix issues (immediate / this week / this month)
- 6 Live Charts - RPM, Speed, Temperature, Fuel Efficiency, Engine Load, Battery
- Trip Tracking - View past trips with detailed metrics
- Fuel Economy - Track MPG estimates
- Pattern Detection - Identify driving patterns (startup → highway → city → stop)
- Glassmorphic Design - Modern, professional interface
- Responsive Layout - Works on desktop, tablet, and mobile
- Live Updates - No page refresh needed
- Dark Theme - Easy on the eyes, looks professional
- Python 3.8+
- OBD-II Bluetooth adapter (optional - works with simulator)
# Clone the repository
git clone https://github.com/jturner0815/neurodrive.git
cd neurodrive
# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install dependencies
cd backend
pip install -r requirements.txt
# Set up environment variables
echo "GROQ_API_KEY=your_key_here" > .env
# Initialize database
python database.py
# Run the application
python app.py
Access the Dashboard
Open your browser to: http://localhost:5000
🔧 Configuration
Get a Free Groq API Key
Go to https://console.groq.com
Sign up (free account)
Create API key
Add to backend/.env: