Krita-AI-Diffusion项目模型下载问题解决方案

在使用Krita-AI-Diffusion项目时，用户可能会遇到"ModuleNotFoundError: No module named 'ai_diffusion'"的错误提示。这个问题通常出现在尝试运行download_models.py脚本时，特别是在ComfyUI环境中。

问题根源分析

该错误表明Python解释器无法找到名为"ai_diffusion"的模块。这通常由以下原因导致：

1. 运行环境不正确：用户可能没有在正确的目录下执行脚本
2. 项目结构不完整：直接从Git仓库克隆而非使用发布版本
3. 路径配置问题：Python的模块搜索路径中没有包含所需目录

解决方案

方法一：使用发布版本

推荐从项目发布页面下载打包好的ZIP文件，解压后找到download_models.py脚本运行。这种方法确保了正确的目录结构，避免了从Git仓库直接克隆可能带来的问题。

方法二：正确设置运行环境

如果确实需要从源代码运行，请确保：

1. 在ai_diffusion项目根目录下执行脚本
2. Python的当前工作目录包含完整的项目结构
3. 所有依赖项已正确安装

方法三：ComfyUI环境下的特殊处理

对于ComfyUI用户，需要注意：

1. 脚本应该位于插件文件夹内
2. 如果没有Krita环境，需要手动下载发布版本
3. 确保Python环境变量配置正确

最佳实践建议

1. 始终优先使用官方发布的打包版本
2. 运行脚本前确认当前工作目录
3. 对于服务器环境，考虑使用虚拟环境隔离依赖
4. 遇到模块缺失错误时，首先检查PYTHONPATH环境变量

通过以上方法，大多数用户应该能够解决模型下载脚本运行时的模块缺失问题。如果问题仍然存在，建议检查Python环境配置和项目文件完整性。