diff --git a/CLAUDE.md b/CLAUDE.md index 84d098a..f84f8a5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -17,6 +17,12 @@ A full-stack video query application using Google Gemini 2.0 Flash Exp AI for vi cd backend python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate + +# For Python 3.10 (use special requirements file) +pip install -r requirements-py310.txt +bash fix_jose.sh # Fix jose module conflict if needed + +# For other Python versions pip install -r requirements.txt # Install system dependencies (Ubuntu/Debian) @@ -75,8 +81,8 @@ npm run build ### Frontend - **Development server**: `npm start` (port 3000) -- **Production build**: `npm run build` -- **Build with deploy script**: `./build.sh` +- **Production build**: `./build.sh` (recommended - sets PUBLIC_URL automatically) +- **Manual production build**: `PUBLIC_URL=/video_query npm run build` (if not using script) ### Video Processing - **Standalone script**: `python video_query.py [--prompt "Your custom prompt"]` @@ -97,6 +103,12 @@ npm run build cd /path/to/video-query/backend python3 -m venv venv source venv/bin/activate + + # For Python 3.10 + pip install -r requirements-py310.txt + bash fix_jose.sh + + # For other Python versions pip install -r requirements.txt ``` @@ -150,7 +162,11 @@ EOF 2. **Build for production**: ```bash cd frontend - npm run build + # Option 1: Use build script (recommended - sets PUBLIC_URL automatically) + ./build.sh + + # Option 2: Manual build with PUBLIC_URL + PUBLIC_URL=/video_query npm run build ``` 3. **Deploy to web server**: @@ -378,6 +394,11 @@ sudo systemctl restart video-query # Check ffmpeg installation which ffprobe ffprobe -version + +# Python 3.10: Fix jose module SyntaxError +# If you see: "SyntaxError: Missing parentheses in call to 'print'" +cd backend +bash fix_jose.sh ``` ### Frontend Issues @@ -396,6 +417,11 @@ tail -f /var/log/apache2/error.log tail -f /var/log/nginx/error.log ``` +**Static Assets Not Loading** (JS/CSS 404 errors): +- **Symptom**: `Loading failed for