DriverTrac/docs/QUICK_START.md

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

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:

'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

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:

# 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

pip install --upgrade pip
pip install -r requirements.txt --force-reinstall

CUDA/GPU Issues

If you have CUDA installed but want CPU-only:

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)