​

Troubleshooting

​

Installation Issues

​

Python Version Too Old

requires-python >=3.11

sudo apt update
sudo apt install python3.11

python --version
# or
python3.11 --version

​

uv Sync Fails

Failed to download distribution

1. Check internet connection
2. Clear uv cache:
   rm -rf ~/.cache/uv
   uv sync
   
3. Use verbose mode:
   uv sync -v
   

​

FFmpeg Not Found

FileNotFoundError: [Errno 2] No such file or directory: 'ffmpeg'

sudo apt install ffmpeg

ffmpeg -version

​

ImageMagick Not Detected

ERROR: IMAGEMAGICK_BINARY is not set and no ImageMagick executable was detected in PATH.

sudo apt install imagemagick

IMAGEMAGICK_BINARY="/usr/local/bin/magick"

​

Configuration Issues

​

Missing Environment Variables

ERROR: The following environment variables are missing: PEXELS_API_KEY, TIKTOK_SESSION_ID

TIKTOK_SESSION_ID="your_session_id_here"
PEXELS_API_KEY="your_pexels_key_here"

​

TikTok Session Expired

TTS failed: 401 Unauthorized

1. Log into TikTok in your browser
2. Open Developer Tools (F12)
3. Go to Application → Cookies
4. Copy new sessionid value
5. Update .env:
   TIKTOK_SESSION_ID="new_session_id_here"
   

​

Pexels API Key Invalid

No videos found to download.

1. Verify API key at pexels.com/api
2. Check quota (200 requests/hour on free tier)
3. Try a broader search term
4. Update .env with valid key

​

Ollama Issues

​

No Ollama Models in Dropdown

• Frontend dropdown is empty
• No models shown in UI

1. Ensure Ollama is running:
   ollama serve
   
2. Check models are installed:
   ollama list
   
3. Pull a model if needed:
   ollama pull llama3.1:8b
   
4. Verify OLLAMA_BASE_URL:
   .env

   OLLAMA_BASE_URL="http://localhost:11434"
   
5. Test connectivity:
   curl http://localhost:11434/api/tags
   

​

Model Not Found Error

RuntimeError: Ollama model 'llama3.1:8b' is not installed.
Available models: mistral:7b
Install it with: ollama pull llama3.1:8b

ollama pull llama3.1:8b

OLLAMA_MODEL="mistral:7b"

​

Ollama Connection Refused

Failed to connect to Ollama: Connection refused

1. Start Ollama:
   ollama serve
   
2. Check if running:
   curl http://localhost:11434/api/tags
   
3. If using Docker, verify OLLAMA_BASE_URL:
   .env

   OLLAMA_BASE_URL="http://host.docker.internal:11434"
   
4. Test from container:
   docker exec -it backend curl http://host.docker.internal:11434/api/tags
   

​

Video Generation Issues

​

Job Stays in Queued State

• Job never starts processing
• Status remains “queued”

1. Ensure worker is running:
   uv run python Backend/worker.py
   
2. Check worker logs for errors
3. Verify database connectivity:
   sqlite3 moneyprinter.db "SELECT * FROM generation_jobs;"
   
4. Restart worker:
   # Ctrl+C to stop
   uv run python Backend/worker.py
   

​

No Stock Videos Found

RuntimeError: No videos found to download.

1. Verify PEXELS_API_KEY in .env
2. Try a broader video subject
3. Check Pexels quota (200 requests/hour)
4. Use a different search term

​

Subtitle Rendering Error

RuntimeError: Could not render final video. Check subtitle/font/ImageMagick setup.

1. Ensure ImageMagick is installed:
   magick --version
   
2. Set IMAGEMAGICK_BINARY in .env if not auto-detected
3. Check font file exists:
   ls -la fonts/bold_font.ttf
   
4. ImageMagick policy error (Linux): Edit /etc/ImageMagick-7/policy.xml and comment out:
   <!-- <policy domain="path" rights="none" pattern="@*" /> -->
   

​

TTS Generation Fails

TikTok TTS failed

1. Check TIKTOK_SESSION_ID is valid
2. Refresh session ID (see above)
3. Try a different voice
4. Check for special characters in script
5. Verify internet connection

​

Out of Memory Error

Killed
Out of memory

1. Use smaller Ollama model:
   ollama pull mistral:7b
   
2. Reduce render threads:
   {"threads": 2}
   
3. Close other applications
4. Add swap space (Linux):
   sudo fallocate -l 8G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile
   

​

Docker Issues

​

Ollama Connection Refused (Docker)

Failed to connect to Ollama: Connection refused

1. Ensure Ollama runs on host:
   ollama serve
   
2. Verify OLLAMA_BASE_URL:
   .env

   OLLAMA_BASE_URL="http://host.docker.internal:11434"
   
3. Test connectivity:
   docker exec -it backend curl http://host.docker.internal:11434/api/tags
   
4. Linux: Check host.docker.internal resolves:
   docker exec -it backend ping host.docker.internal
   

​

Postgres Healthcheck Failing

postgres healthcheck failed

1. Check logs:
   docker compose logs postgres
   
2. Verify credentials match:
   • .env file
   • docker-compose.yml
   • DATABASE_URL
3. Restart services:
   docker compose down
   docker compose up
   

​

Worker Not Processing Jobs (Docker)

• Worker container running
• Jobs stay queued

1. Check worker logs:
   docker compose logs -f worker
   
2. Verify DATABASE_URL:
   docker exec -it worker env | grep DATABASE_URL
   
3. Ensure backend started first:
   docker compose up backend
   # Wait for "Running on http://0.0.0.0:8080"
   docker compose up worker
   

​

Permission Errors (Docker)

PermissionError: [Errno 13] Permission denied: '/temp/output.mp4'

1. Fix volume permissions:
   chmod -R 777 ./files
   chmod -R 777 ./temp
   
2. Run as your user:
   docker-compose.yml

   services:
     worker:
       user: "1000:1000"  # Your UID:GID
   

​

YouTube Upload Issues

​

OAuth Consent Screen Not Approved

Error 403: access_denied

1. Go to OAuth consent screen
2. Under Test users, click Add Users
3. Add your email
4. Save

​

Quota Exceeded

HttpError 403: quotaExceeded

1. Wait 24 hours for quota reset
2. Request quota increase in Google Cloud Console
3. Use multiple projects

​

Token Expired

HttpError 401: invalid_grant
Token has been expired or revoked.

rm Backend/main.py-oauth2.json
# Next upload will trigger re-auth

​

Frontend Issues

​

Cannot Connect to Backend

• Frontend loads but API calls fail
• Console errors

1. Ensure backend is running:
   uv run python Backend/main.py
   
2. Check backend is on port 8080:
   curl http://localhost:8080/api/models
   
3. Open frontend via local server, not file://:
   # Correct:
   python3 -m http.server 3000 --directory Frontend
   # Open http://localhost:3000
   
   # Wrong:
   # Opening Frontend/index.html directly
   
4. Check CORS if using different ports

​

Progress Not Updating

• Job starts but no progress logs
• Frontend stuck

1. Check browser console for errors
2. Verify worker is running
3. Check events endpoint:
   curl "http://localhost:8080/api/jobs/<jobId>/events?after=0"
   
4. Refresh page and check job status

​

Getting Help

​

Before Opening an Issue

• Searched existing issues
• Using Python 3.11+
• All dependencies installed
• Required environment variables set
• Ollama is running
• Worker is running
• Checked logs for errors

1. MoneyPrinter version (git commit hash)
2. Operating system and version
3. Python version: python --version
4. Error message (full traceback)
5. Steps to reproduce
6. Configuration (.env with secrets redacted)