InsightFace中不存在“Buffalo框架”，buffalo_l是其内置预训练模型名称，非独立框架；正确做法是安装insightface≥0.7.3后调用FaceAnalysis(name='buffalo_l')自动下载，或手动解压至~/.insightface/models/buffalo_l/路径。
InsightFace 没有叫 “Buffalo 框架” 的独立项目——你遇到的其实是 buffalo_l 模型包，它是 InsightFace 官方提供的预训练人脸识别模型名称，不是可单独安装的框架。直接 pip install buffalo 或类似操作会失败，且无意义。
为什么搜“Buffalo框架安装”会走偏？
关键词混淆是主要问题：buffalo_l 是 InsightFace 内部使用的模型代号（代表 large-scale face recognition model），和 Python Web 框架 Buffalo、或 Buffalo 公司硬件完全无关。大量中文搜索结果把“buffalo_l 模型”误称为“Buffalo 框架”，导致用户执行错误命令，比如：
-
pip install buffalo→ 安装的是另一个推荐系统库，与人脸无关 -
git clone https://github.com/buffalo-xxx→ 找不到对应仓库 - 手动下载 zip 解压到任意目录 → 路径不匹配，InsightFace 根本不识别
正确做法：让 InsightFace 自动下载 buffalo_l
只要 InsightFace 版本 ≥ 0.7.3（推荐用 insightface==0.7.3），调用 FaceAnalysis() 时指定 name='buffalo_l'，它就会自动触发下载流程，无需手动干预：
- 首次运行
app.prepare()时，模型自动下载到~/.insightface/models/buffalo_l/（Linux/macOS）或%USERPROFILE%\.insightface\models\buffalo_l\（Windows） - 网络受限时，可手动下载
buffalo_l模型包（官方 release 页面：https://github.com/deepinsight/insightface/releases/tag/v0.7.3），解压后放入上述路径即可 - 若需指定自定义路径（如 ComfyUI 场景），构造时传
root参数：FaceAnalysis(name='buffalo_l', root='/path/to/your/insightface/models')
ComfyUI 用户特别注意模型存放位置
在 ComfyUI 中使用 FaceID 节点时，buffalo_l 必须放在 ComfyUI/models/insightface/models/buffalo_l/，而不是用户家目录下的 .insightface。这是因为 ComfyUI 的 utils.py 显式拼接了路径：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
path = os.path.join(folder_paths.models_dir, "insightface") model = FaceAnalysis(name=model_name, root=path, providers=[provider + 'ExecutionProvider'])
常见错误包括：
- 只把模型丢进
~/.insightface→ ComfyUI 找不到 - 解压后多了一层文件夹（如
buffalo_l/buffalo_l/）→ 模型结构错乱，加载失败 - 权限不足导致写入失败（尤其 Windows 下杀毒软件拦截）→ 日志里出现
OSError: [Errno 13] Permission denied
真正要盯住的只有三件事：InsightFace 版本锁死为 0.7.3、onnxruntime 匹配 GPU/CPU、buffalo_l 目录结构严格符合 models/buffalo_l/...onnx 两级路径——其余所谓“框架安装”，全是误导。
