乐于分享
好东西不私藏

comfyui 安装llama-cpp-python-图文教程

comfyui 安装llama-cpp-python-图文教程
▍PART comfyUI教程合集
    comfyui安装熟悉界面提示词翻译(CLIP文本编码)整线下载模型models、工作流、解决报错报红界面整理(固定节点、分组)comfyUI图生图
    ▍PART 效果预览
    ▍PART 序
    1. 很多反推的大模型都用的到,所以我想了下单独写一篇教程算了
    2. 有下面这些
    3. LLaVA 1.5/1.6, MiniCPM-V 2.6, Moondream 2, Qwen2.5-VL, Qwen3-VLJoyCaption, Obsidian, NanoLLaVA, Llama 3 Vision Alpha, InternVL3.5, Xiaomi MiMo-VL, LiquidAI LFM2-VL, Kwai Keye-VL, AIDC-AI Ovis, Mistral RealworldQA V0.2
    4. 所以我单独从Qwen3-VL教程里分离出来写一篇。
    5. Qwen3-VL教程我发在底部评论区(本文在微信端打开才可以看到评论区)
    ▍PART 流程简要
    1. 准备环境:关闭 ComfyUI → 打开任务管理器(Ctrl+Alt+Esc)→ 结束所有 python.exe 进程(确保无残留)。

    2. 定位 ComfyUI 内置 Python 路径:找到 ComfyUI 目录下的 .venv\Scripts\ 文件夹,其中包含 python.exe,完整路径如 F:\aiApp\comfyUIFile\.venv\Scripts\python.exe

    3. 检查版本并下载对应 whl:以管理员身份打开 CMD → 运行 [你的python路径] -V 记录版本号(如 3.12.1)→ 根据版本号(cp312)下载 llama_cpp_python-*.whl(可从 GitHub 或百度网盘获取,用户提供网盘链接)。

    4. 强制安装并验证:在管理员 CMD 中执行强制重装命令(替换自己的 python 路径和 whl 文件路径):

      [python路径] -m pip install --upgrade --force-reinstall "[whl完整路径]"
    5. 成功后运行验证命令:

    [python路径] -c "from llama_cpp.llama_chat_format import Qwen3VLChatHandler, Qwen25VLChatHandler; print('handlers OK')"

    输出 handlers OK 即安装成功。

    ▍PART 正文-图文教程

    1. 关掉comfyui的应用

    2. 然后ctrl+alt+esc调出任务管理器

    3. 找到python这个执行程序(没找到就是没有正在运行python的跳过这个步骤)

    4. 右键结束任务

    5. 确保目前没有python正在运行(这个很重要哈!我几个次试都卡这里)

    • 首先!comfyui是有自带python.exe的!!!!他是和你window外面的python隔离的,这你得知道!

    • 然后我们先得找到他

    • 我是comfyui目录的\.venv\Scripts文件下

    • 记录这个路径!!!!!

      开始菜单输入cmd 在命令符右键以管理员形式打开

      刚才你哪个地址记下来,尾巴拼上python.exe -V格式如下(记得换成你本地comfyui里面的python路径
      F:\aiApp\comfyUIFile\.venv\Scripts\python.exe -V
      然后鼠标右键粘贴到命令上运行(有git,懂git的你也别跳步骤,我个搞了14年编程的都能被坑,你别费心思了。每个步骤乖乖的照着来)
      这一步是看你的版本号
      记录下来你的版本号,我的是3.12.1

      然后输入下面代码记得换成你本地comfyui里面的python路径

      F:\aiApp\comfyUIFile\.venv\Scripts\python.exe -c "import sys;print(sys.executable)"
      出来你本地的python路径代表识别到了,其实-V的时候出来版本号就识别到了
      你如果有魔法,你就点开llama-cpp-python下载库 https://github.com/JamePeng/llama-cpp-python/releases?page=1
      你没魔法你就点网盘下https://pan.baidu.com/s/1tAvtoZlrGFtvYNjN3asSUw?pwd=fcwi 
      我python版本是3.12.1,所以对应下cp312   
      如果你是3.11 你就下311 以此类推
      • 把他丢到你随便一个盘根目录。

      • 我默认你之前装失败过一次哈

      • 所以大家都用强制重新安装llama_cpp_python的命令

      • 以管理员权限打开cmd命令符(前面演示过)

      • 输入的命令在下面,记得!改!

      • 一个是python路径

      • 一个是llama_cpp_python-0.3.36+cu130.basic-cp312-cp312-win_amd64.whl 名字和路径也要换

      F:\aiApp\comfyUIFile\.venv\Scripts\python.exe -m pip install --upgrade --force-reinstall "F:\aiApp\llama_cpp_python-0.3.36+cu130.basic-cp312-cp312-win_amd64.whl"
      运行成功他是下面这样的
      • 运行失败,你要对下,哪里错了?
      • 是路径错了?
      • 还是版面本错了?
      • 还是llama_cpp_python名称没改?
      • 还是斜杆错了?
      • 能过这关的 
      • 不是一般人呀我们真厉害
      • 装完你在看看是不是成功的。
      • 记得改python路径。
      F:\aiApp\comfyUIFile\.venv\Scripts\python.exe -c "from llama_cpp.llama_chat_format import Qwen3VLChatHandler, Qwen25VLChatHandler; print('handlers OK')"

      出来handlers OK就是安装成功了