| 1 | # Troubleshooting |
| 2 | |
| 3 | Having issues? Here are solutions to common problems. |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Installation Issues |
| 8 | |
| 9 | ### Dependency installation failed |
| 10 | |
| 11 | ```bash |
| 12 | # Clean cache |
| 13 | uv cache clean |
| 14 | |
| 15 | # Reinstall |
| 16 | uv sync |
| 17 | ``` |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Configuration Issues |
| 22 | |
| 23 | ### ComfyUI connection failed |
| 24 | |
| 25 | **Possible Causes**: |
| 26 | - ComfyUI not running |
| 27 | - Incorrect URL configuration |
| 28 | - Firewall blocking |
| 29 | |
| 30 | **Solutions**: |
| 31 | 1. Confirm ComfyUI is running |
| 32 | 2. Check URL configuration (default `http://127.0.0.1:8188`) |
| 33 | 3. Test by accessing ComfyUI address in browser |
| 34 | 4. Check firewall settings |
| 35 | |
| 36 | ### LLM API call failed |
| 37 | |
| 38 | **Possible Causes**: |
| 39 | - Incorrect API Key |
| 40 | - Network issues |
| 41 | - Insufficient balance |
| 42 | |
| 43 | **Solutions**: |
| 44 | 1. Verify API Key is correct |
| 45 | 2. Check network connection |
| 46 | 3. Review error message details |
| 47 | 4. Check account balance |
| 48 | |
| 49 | --- |
| 50 | |
| 51 | ## Generation Issues |
| 52 | |
| 53 | ### Video generation failed |
| 54 | |
| 55 | **Possible Causes**: |
| 56 | - Corrupted workflow file |
| 57 | - Models not downloaded |
| 58 | - Insufficient resources |
| 59 | |
| 60 | **Solutions**: |
| 61 | 1. Check if workflow file exists |
| 62 | 2. Confirm ComfyUI has downloaded required models |
| 63 | 3. Check disk space and memory |
| 64 | |
| 65 | ### Image generation failed |
| 66 | |
| 67 | **Solutions**: |
| 68 | 1. Check if ComfyUI is running properly |
| 69 | 2. Try manually testing workflow in ComfyUI |
| 70 | 3. Check workflow configuration |
| 71 | |
| 72 | ### TTS generation failed |
| 73 | |
| 74 | **Solutions**: |
| 75 | 1. Check if TTS workflow is correct |
| 76 | 2. If using voice cloning, check reference audio format |
| 77 | 3. Review error logs |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## Performance Issues |
| 82 | |
| 83 | ### Slow generation speed |
| 84 | |
| 85 | **Optimization Tips**: |
| 86 | 1. Use local ComfyUI (faster than cloud) |
| 87 | 2. Reduce number of scenes |
| 88 | 3. Use faster LLM (e.g., Qianwen) |
| 89 | 4. Check network connection |
| 90 | |
| 91 | --- |
| 92 | |
| 93 | ## Other Issues |
| 94 | |
| 95 | Still having problems? |
| 96 | |
| 97 | 1. Check project [GitHub Issues](https://github.com/AIDC-AI/Pixelle-Video/issues) |
| 98 | 2. Submit a new Issue describing your problem |
| 99 | 3. Include error logs and configuration details for quick diagnosis |
| 100 | |
| 101 | --- |
| 102 | |
| 103 | ## View Logs |
| 104 | |
| 105 | Log files are located in project root: |
| 106 | - `api_server.log` - API service logs |
| 107 | - `test_output.log` - Test logs |
| 108 | |
| 109 |