ChatMask

| Symptom | Cause | Fix | |---|---|---| | --bbox-json ... but N images were found | Multiple images in input dir with --bbox-json | Use a separate $IN_DIR per image and run process.py once per image | | python3 -m venv fails | Missing venv module | Run apt-get install -y python3-venv then re-run Setup | | git clone fails | No git installed or no network | Run apt-get install -y git or check network connectivity | | No images found in input directory | Copy step failed | Check ls $IN_DIR/ and confirm the filename is exact | | Image copied unchanged with SKIPPED in summary | JSON parse failure | Check printed warning; verify the bbox JSON is valid | | Wrong regions pixelated | Bounding boxes were inaccurate | Re-analyse the image and adjust coordinates; try --pixel-mode B |