diff --git a/assets/FAQ.md b/assets/FAQ.md new file mode 100644 index 0000000..56af417 --- /dev/null +++ b/assets/FAQ.md @@ -0,0 +1,69 @@ +### Installation Issues + +**Q: How to properly install ComfyUI-Copilot without errors?** +**A:** The recommended way is to clone the repo into `ComfyUI/custom_nodes` and install requirements: + +```bash +cd ComfyUI/custom_nodes +git clone https://github.com/AIDC-AI/ComfyUI-Copilot.git +cd ComfyUI-Copilot +pip install -r requirements.txt +``` + +On Windows, use the embedded Python shipped with ComfyUI, e.g.: + +```bash +python_embedded\python.exe -m pip install -r requirements.txt +``` + +(Avoid using Manager installation if possible.) + +--- + +**Q: Why does pip install show dependency conflicts for ComfyUI-Copilot?** +**A:** This usually happens due to incompatible OpenAI library versions. Fix by editing +`custom_nodes/ComfyUI-Copilot/requirements.txt` to ensure: + +* `openai>=1.5.0` +* `openai-agents>=0.3.0` + Then reinstall with: + +```bash +pip install --force-reinstall -r requirements.txt +``` + +--- + +**Q: Why does installing via ComfyUI Manager fail?** +**A:** Manager may cause permission errors. Solutions: + +1. Run ComfyUI with admin/root privileges, e.g. `sudo python main.py`. +2. If update fails, delete the Copilot folder and reinstall manually. +3. Manual Git installation is generally more reliable. + +--- + +### Runtime & UI Issues + +**Q: Why is ComfyUI-Copilot blank or not showing after installation?** +**A:** You must click the **Copilot activation button** on the left panel of ComfyUI to enable it. +Also make sure you paste and save a valid API key, otherwise the panel stays blank. + +--- + +**Q: Why does the Copilot UI break or disappear with a non-default theme?** +**A:** This is a known bug. Users reported that dark/custom themes cause UI issues. +Workaround: switch back to the **default theme**. + +--- + +**Q: How to get and activate the Copilot API key?** +**A:** Open Copilot panel → click “*” button → enter your email → you’ll receive an API key. +Paste the key into the input field and click **Save** to activate. + +--- + +**Q: Does ComfyUI-Copilot support offline mode or local AI models?** +**A:** Currently no. Copilot relies on external LLM APIs (e.g. OpenAI GPT, Claude) and requires internet access. + +--- \ No newline at end of file diff --git a/assets/FAQ_CN.md b/assets/FAQ_CN.md new file mode 100644 index 0000000..a33f694 --- /dev/null +++ b/assets/FAQ_CN.md @@ -0,0 +1,69 @@ +### 安装相关 + +**Q: 如何正确安装 ComfyUI-Copilot?** +**A:** 推荐方法是在 `ComfyUI/custom_nodes` 文件夹下克隆仓库,并安装依赖: + +```bash +cd ComfyUI/custom_nodes +git clone https://github.com/AIDC-AI/ComfyUI-Copilot.git +cd ComfyUI-Copilot +pip install -r requirements.txt +``` + +在 Windows 环境下,需使用 ComfyUI 自带的 Python,例如: + +```bash +python_embedded\python.exe -m pip install -r requirements.txt +``` + +(避免使用插件管理器安装时权限问题。) + +--- + +**Q: 为什么安装时会遇到 pip 依赖冲突?** +**A:** 主要原因是 OpenAI 相关库版本不兼容。解决方案:修改 +`custom_nodes/ComfyUI-Copilot/requirements.txt`,确保依赖如下: + +* `openai>=1.5.0` +* `openai-agents>=0.3.0` + 然后执行: + +```bash +pip install --force-reinstall -r requirements.txt +``` + +--- + +**Q: 使用 ComfyUI Manager 安装时出错怎么办?** +**A:** Manager 插件可能因权限不足报错。解决办法: + +1. 用管理员权限运行 ComfyUI,例如 `sudo python main.py`。 +2. 如果更新失败,删除 `ComfyUI-Copilot` 文件夹,手动重新安装。 +3. 手动 Git 安装通常比 Manager 更可靠。 + +--- + +### 运行与界面相关 + +**Q: 安装后 Copilot 界面空白或不显示怎么办?** +**A:** 需要在 ComfyUI 界面左侧点击 **Copilot 启动按钮** 才能激活插件。 +另外必须先输入并保存 API Key,否则界面不会加载正常。 + +--- + +**Q: 为什么 Copilot 界面在暗色主题下显示异常?** +**A:** 已有用户反馈更换主题后 Copilot 窗口显示不正常。 +解决方法:切换回 **默认主题** 使用。 + +--- + +**Q: 如何获取并激活 Copilot API Key?** +**A:** 在 Copilot 界面点击 “*” 按钮 → 输入邮箱 → 系统会发送 API Key。 +将密钥粘贴回输入框并点击 **保存**,即可完成激活。 + +--- + +**Q: Copilot 是否支持离线运行或本地模型?** +**A:** 目前不支持。Copilot 依赖远程大语言模型(如 OpenAI GPT、Claude),必须联网使用。 + +--- \ No newline at end of file diff --git a/poster.html b/poster.html index 06ec37f..c9fc1c0 100644 --- a/poster.html +++ b/poster.html @@ -310,7 +310,7 @@