# Quick Start Guide

## Current Status

⚠️ **Project Status**: Non-functional - Requires critical bug fixes before running

**Dependencies Installed**: 2/11 (18%)
- ✅ numpy
- ✅ pyyaml
- ❌ 9 packages missing

## Installation Steps

### 1. Install Dependencies

```bash
cd /home/tech4biz/work/tools/Driver_DSMS_ADAS
pip install -r requirements.txt
```

**Expected Time**: 10-15 minutes (depends on internet speed)
**Disk Space Required**: ~5GB

### 2. Configure API Keys

Edit `track_drive.py` and replace:
```python
'roboflow_api_key': 'YOUR_FREE_ROBOFLOW_KEY',  # Replace
```

With your actual Roboflow API key (get free key at https://roboflow.com)

### 3. Run Dependency Check

```bash
python3 check_dependencies.py
```

Should show all packages installed.

### 4. ⚠️ **DO NOT RUN YET** - Critical Bugs Present

The current code has critical bugs that will cause crashes:
- Optical flow implementation is incorrect
- VideoMAE JIT scripting will fail
- YOLO ONNX parsing is wrong

**See ASSESSMENT_REPORT.md for details and fixes.**

## Testing After Fixes

Once critical bugs are fixed:

```bash
# Test with webcam
streamlit run track_drive.py

# Or test with video file (modify code to use cv2.VideoCapture('video.mp4'))
```

## Performance Expectations

**Current (After Fixes):**
- FPS: 5-8 (estimated)
- Memory: 4-6GB
- CPU: 70-90%

**Target (After Optimizations):**
- FPS: 12-15
- Memory: 2-3GB
- CPU: <80%

## Troubleshooting

### Import Errors
```bash
pip install --upgrade pip
pip install -r requirements.txt --force-reinstall
```

### CUDA/GPU Issues
If you have CUDA installed but want CPU-only:
```bash
pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
```

### Memory Issues
Reduce model sizes or use smaller input resolutions in config.

## Next Steps

1. ✅ Install dependencies (this guide)
2. 🔴 Fix critical bugs (see ASSESSMENT_REPORT.md Phase 1)
3. 🟡 Optimize performance (see ASSESSMENT_REPORT.md Phase 2)
4. 🟢 Improve accuracy (see ASSESSMENT_REPORT.md Phase 3)