QC Service (prototype)

Run it (WSL2 / Ubuntu)

1. Install deps:

sudo apt update
sudo apt install -y ffmpeg python3 python3-venv

2. Setup venv + install Python packages:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Install web build deps + compile TypeScript:

npm install
npx tsc -p tsconfig.json

4. Start the API (Terminal A):

source .venv/bin/activate
uvicorn app.main:app --host 0.0.0.0 --port 8000

5. Start the worker (Terminal B):

source .venv/bin/activate
python -m worker.worker

Check it’s running

• Open UI: http://localhost:8000/ui/
• Health check:

curl http://localhost:8000/health

Quick test upload

curl -F "media=@/mnt/c/path/to/video.mp4" http://localhost:8000/v1/qc-jobs

Then paste the returned job_id into: http://localhost:8000/ui/jobs.html