AnimateDiff本地部署需严格匹配环境与路径：一、装CUDA 12.1驱动，建conda环境并安装对应PyTorch；二、克隆v1.5.0代码，放SD1.5模型至models/diffusion_models；三、下载motion module权重至models/motion_modules；四、修改anima.yaml中model_path和motion_module_path为本地绝对路径；五、运行inference.py生成动画，遇类型错误需加model.float()。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地运行AnimateDiffAI实现一键生成动画，但发现环境配置复杂、依赖冲突或模型加载失败，则可能是由于Python环境、CUDA版本或模型权重路径不匹配所致。以下是完成AnimateDiff本地部署的具体步骤：
一、准备基础运行环境
AnimateDiff依赖特定版本的PyTorch和CUDA工具链，需确保系统级GPU支持与Python包版本严格对齐。使用不兼容的torch版本将导致模型无法初始化或forward报错。
1、安装NVIDIA驱动，确认驱动版本支持CUDA 11.8或12.1（推荐12.1）。
2、创建独立conda环境：conda create -n animatediff python=3.10。
3、激活环境后执行：pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121。
4、验证CUDA可用性：python -c "import torch; print(torch.cuda.is_available())"，输出True为成功。
二、克隆并配置AnimateDiff代码库
官方GitHub仓库包含核心推理逻辑与插件结构，需拉取稳定分支而非main最新提交，避免API变动引发Pipeline中断。
1、执行git clone https://github.com/guoyww/AnimateDiff.git。
2、切换至v1.5.0标签：cd AnimateDiff && git checkout v1.5.0。
3、安装项目依赖：pip install -r requirements.txt。
4、手动创建models/diffusion_models目录，并将SD1.5基础模型ckpt文件放入该路径，文件名设为diffusion_pytorch_model.bin。
三、下载并放置Motion Module权重
Motion Module是AnimateDiff区别于普通Stable Diffusion的关键组件，缺失该模块将导致generate函数抛出KeyError: 'motion_modules'异常。
1、访问Hugging Face Hub搜索AnimateDiff-Motion-Module，下载animatediff_motion_module_v15.safetensors。
2、将文件移至models/motion_modules/目录下，确保路径为models/motion_modules/animatediff_motion_module_v15.safetensors。
3、检查文件完整性：sha256sum models/motion_modules/animatediff_motion_module_v15.safetensors，比对官方提供的哈希值是否一致。
四、修改配置文件适配本地路径
默认config/anima.yaml中预设路径指向云端模型，需显式重写本地路径参数，否则加载时会触发HTTP 404错误或OSError: No such file。
1、打开config/anima.yaml，定位model_path字段。
2、将原值"https://huggingface.co/..."替换为本地绝对路径，例如/home/user/AnimateDiff/models/diffusion_models/diffusion_pytorch_model.bin。
3、同步修改motion_module_path字段，指向前述safetensors文件的完整路径。
4、保存文件后，用python -m yaml.parser测试yaml语法是否合法，无报错即生效。
五、运行推理脚本生成首段动画
直接调用scripts/inference.py可绕过WebUI依赖，适合验证核心功能是否就绪。该方式跳过Gradio启动开销，快速反馈模型加载与采样结果。
1、准备提示词文本文件prompt.txt，单行写入"anime style, a cat dancing, vibrant colors"。
2、执行命令：python scripts/inference.py --config config/anima.yaml --prompt_path prompt.txt --n_samples 1 --steps 25。
3、等待控制台输出"Saving video to outputs/xxx.mp4"，检查该路径下MP4文件是否可正常播放。
4、若出现RuntimeError: "expected scalar type Half but found Float"，需在inference.py第87行附近插入model = model.float()强制类型转换。
