97 lines
2.0 KiB
Markdown
97 lines
2.0 KiB
Markdown
# 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)
|
|
|