| 1 | # FAQ |
| 2 | |
| 3 | Frequently Asked Questions. |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Installation |
| 8 | |
| 9 | ### Q: How to install uv? |
| 10 | |
| 11 | ```bash |
| 12 | curl -LsSf https://astral.sh/uv/install.sh | sh |
| 13 | ``` |
| 14 | |
| 15 | ### Q: Can I use something other than uv? |
| 16 | |
| 17 | Yes, you can use traditional pip + venv approach. |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Configuration |
| 22 | |
| 23 | ### Q: Do I need to configure ComfyUI? |
| 24 | |
| 25 | **Not necessarily** - it depends on your template choice: |
| 26 | |
| 27 | | Template Type | ComfyUI | Best For | Speed | |
| 28 | |--------------|---------|----------|-------| |
| 29 | | Text-only<br/>(e.g., `simple.html`) | ❌ Not needed | Quotes, announcements, reading prompts | ⚡⚡⚡ Very fast | |
| 30 | | AI Images<br/>(e.g., `default.html`) | ✅ Required | Rich visual content | ⚡ Standard | |
| 31 | |
| 32 | **Tip**: Beginners can start with text-only templates for instant zero-barrier experience! |
| 33 | |
| 34 | **Alternative**: If you need AI images but don't want local ComfyUI, use RunningHub cloud service. |
| 35 | |
| 36 | ### Q: Which LLMs are supported? |
| 37 | |
| 38 | All OpenAI-compatible LLMs, including: |
| 39 | - Qianwen |
| 40 | - GPT-4o |
| 41 | - DeepSeek |
| 42 | - Ollama (local) |
| 43 | |
| 44 | --- |
| 45 | |
| 46 | ## Usage |
| 47 | |
| 48 | ### Q: How long does first-time usage take? |
| 49 | |
| 50 | Generating a 3-5 scene video takes approximately 2-5 minutes. |
| 51 | |
| 52 | ### Q: What if I'm not satisfied with the video? |
| 53 | |
| 54 | Try: |
| 55 | 1. Change LLM model |
| 56 | 2. Adjust image dimensions and prompt prefix |
| 57 | 3. Change TTS workflow |
| 58 | 4. Try different video templates |
| 59 | |
| 60 | ### Q: What are the costs? |
| 61 | |
| 62 | - **Completely Free**: Ollama + Local ComfyUI = $0 |
| 63 | - **Recommended**: Qianwen + Local ComfyUI ≈ $0.01-0.05/video |
| 64 | - **Cloud Solution**: OpenAI + RunningHub (higher cost) |
| 65 | |
| 66 | --- |
| 67 | |
| 68 | ## Troubleshooting |
| 69 | |
| 70 | ### Q: ComfyUI connection failed |
| 71 | |
| 72 | 1. Confirm ComfyUI is running |
| 73 | 2. Check if URL is correct |
| 74 | 3. Click "Test Connection" in Web interface |
| 75 | |
| 76 | ### Q: LLM API call failed |
| 77 | |
| 78 | 1. Check if API Key is correct |
| 79 | 2. Check network connection |
| 80 | 3. Review error messages |
| 81 | |
| 82 | --- |
| 83 | |
| 84 | ## Other Questions |
| 85 | |
| 86 | Have other questions? Check [Troubleshooting](troubleshooting.md) or submit an [Issue](https://github.com/AIDC-AI/Pixelle-Video/issues). |
| 87 | |
| 88 |