LLaMA-Factory 在 Windows 上怎么安装 GPU 版 PyTorch 和 bitsandbytes?

发布时间:2026/9/13 6:22:22

LLaMA-Factory 在 Windows 上怎么安装 GPU 版 PyTorch 和 bitsandbytes? LLaMA-Factory 在 Windows 上怎么安装 GPU 版 PyTorch 和 bitsandbytes【免费下载链接】LlamaFactoryUnified Efficient Fine-Tuning of 100 LLMs VLMs (ACL 2024)项目地址: https://gitcode.com/GitHub_Trending/ll/LlamaFactory在 Windows 上使用 LLaMA-Factory 跑 GPU 训练时官方源码安装流程之外还有两个 Windows 特有的步骤需要额外手动安装 GPU 版本的 PyTorch以及如果要跑量化 LoRAQLoRA还需要安装 bitsandbytes。本文按 README_zh.md 中「Windows 用户指南」一节的说法给出这两步的安装命令、验证方式和版本注意事项。前提Windows x86-64 系统带 NVIDIA GPUPython 按「软硬件依赖」表要求至少 3.11推荐 3.11torch 至少 2.0.0推荐 2.6.0CUDA 至少 11.6推荐 12.2bitsandbytes 至少 0.39.0推荐 0.43.1。准备先安装 LlamaFactory 本体Windows 的两个附加步骤是在完成基础安装之后做的先把仓库克隆下来并装好git clone --depth 1 https://gitcode.com/GitHub_Trending/ll/LlamaFactory.git cd LlamaFactory pip install -e . pip install -r requirements/metrics.txt可选的额外依赖项还有deepspeed可用pip install -e . pip install -r requirements/metrics.txt -r requirements/deepspeed.txt安装。手动安装 GPU 版 PyTorch文档明确说明Windows 平台需要额外手动安装 GPU 版本的 PyTorch 依赖包可参考 PyTorch 官方的 locally 页面选择与你环境匹配的安装命令。文档给出的主路径命令是pip uninstall torch torchvision torchaudio pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu126第一条命令会卸载环境中已有的 torch、torchvision、torchaudio再按 cu126 索引源重新安装这是 Windows 用户指南中的原始命令照抄即可。如果本机 CUDA 驱动环境与 cu126 索引不对应按文档提示参考 PyTorch 官网选择对应安装命令。验证 PyTorch 是否可用 GPUpython -c import torch; print(torch.cuda.is_available())如果看到True则说明安装成功。另外文档指出一个 Windows 上的已知报错如果训练时遇到类似Cant pickle local object的报错请在训练参数中设置dataloader_num_workers: 0。安装 bitsandbytes 以开启 QLoRA如果要在 Windows 平台上开启量化 LoRAQLoRA需要安装 bitsandbytes。对大多数用户文档建议优先使用官方发布的最新版本pip install bitsandbytes使用 uv 管理虚拟环境的情况可选分支如果使用 uv 管理虚拟环境文档建议在安装好 GPU 版本 PyTorch 之后再执行uv pip install bitsandbytes --no-deps注意顺序先完成上一步的 GPU 版 PyTorch 安装再装 bitsandbytes。注意 CUDA Toolkit 版本安装 bitsandbytes 时文档特别提醒要注意 CUDA Toolkit 版本bitsandbytes 的官方发布包是按不同 CUDA 版本分别构建的Windows x86-64 目前提供了面向 CUDA 11.8–12.6 和 CUDA 12.8–12.9 的不同构建其中支持 RTX 50 系列如 RTX 5060 Tism_120的构建对应 CUDA 12.8–12.9。若当前环境的 CUDA 版本较旧或者需要兼容较老的 Windows / PyTorch 组合文档给出的是第三方预编译版本pip install https://github.com/jllllll/bitsandbytes-windows-webui/releases/download/wheels/bitsandbytes-0.41.2.post2-py3-none-win_amd64.whl该命令直接从 GitHub Release 的 whl 文件安装安装前请确认自己属于「CUDA 版本较旧或需兼容较老 Windows / PyTorch 组合」的情况否则优先走上面的官方pip install bitsandbytes。安装完成后的验证与下一步验证方式文档只明确到 PyTorch 这一层torch.cuda.is_available()输出True。bitsandbytes 本身文档未提供单独的测试命令它的用途是作为 Windows 上开启 QLoRA 的必要依赖——装好后即可在训练配置中启用 QLoRA。装好两个依赖后可以按快速开始跑通一次训练命令路径与验证参照 README_zh.mdllamafactory-cli train examples/train_lora/qwen3_lora_sft.yamlQLoRA 相关的训练配置示例位于 examples/train_qlora/ 目录可结合 examples/README_zh.md 查看参数。llamafactory-cli help可显示帮助信息。限制说明本文命令与注意事项均取自项目文档的 Windows 用户指南面向 Windows x86-64 NVIDIA GPU昇腾 NPU 的 bitsandbytes 安装是另一套流程手动编译 transformers main 分支 double_quantization: false不在本文范围。如果后续还想在 Windows 上开启 FlashAttention-2文档要求使用 flash-attention-windows-wheel 项目中的脚本自行编译与安装这是独立于 PyTorch 和 bitsandbytes 的可选步骤。【免费下载链接】LlamaFactoryUnified Efficient Fine-Tuning of 100 LLMs VLMs (ACL 2024)项目地址: https://gitcode.com/GitHub_Trending/ll/LlamaFactory创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/13 6:17:21

Inno Setup静默安装实战:从参数到脚本打造无人值守安装包

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/13 6:17:21

Linux虚拟串口技术与特殊字节处理实践

1. Linux虚拟串口技术解析虚拟串口(Virtual Serial Port)是Linux系统中一种重要的设备通信机制,它通过软件模拟真实的物理串口设备,为应用程序提供标准的串行通信接口。与物理串口相比,虚拟串口具有配置灵活、不受硬件…

2026/9/13 6:17:21

Java异步编排框架Gobrs-Async:DAG模型与微服务并行调用实践

说实话,第一次看到 Gobrs-Async 这个名字的时候,我以为是某个国外团队做的轮子。真正在项目里用起来才发现,这是一款实打实面向国内互联网场景开源出来的 Java 异步编排框架,诞生背景非常贴地气——就是为了解决微服务架构下 RPC …

2026/9/13 7:22:24

STM32 HAL库定时器实战:从时钟树到PWM精准控制

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/13 7:22:24

AI智能体用户记忆系统:双层架构与工程落地实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/13 7:22:24

Ax+By+C=0的几何本质:A、B、C如何定义直线的方向与位置

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/13 7:22:24

ADK 本地授权码认证全栈演示:authn-adk-all-in-one 实战指南

ADK 本地授权码认证全栈演示:authn-adk-all-in-one 实战指南 【免费下载链接】adk-python An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control. 项目地址: https://gitco…

2026/9/13 7:22:24

Java Web框架性能横评:Spring Boot、Quarkus与轻量级框架对比

1. Java Web框架的江湖地位与选型困境在Java生态圈里,Web框架的演进就像一场没有终点的马拉松。从早期的Struts到后来的Spring MVC,再到如今百花齐放的微服务框架,每个时代都有其标志性的技术选择。作为从业15年的老Javaer,我见证…

2026/9/13 7:17:24

AI Agent跨会话记忆系统架构设计与实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/13 0:01:16

拯救者Y7000黑屏故障排查与维修实战指南

1. 项目概述:一台黑屏的拯救者Y7000,到底卡在哪一步? 联想拯救者Y7000系列笔记本,从2018年第一代搭载i5-8300H开始,到后来的i7-9750H、i7-10750H、i5-11400H,再到2023年款的R7-7840HS,它始终是学…

2026/9/13 0:01:16

拯救者Y7000黑屏故障排查与维修实战指南

1. 项目概述:一台黑屏的拯救者Y7000,到底卡在哪一步? 联想拯救者Y7000系列笔记本,从2018年第一代搭载i5-8300H开始,到后来的i7-9750H、i7-10750H、i5-11400H,再到2023年款的R7-7840HS,它始终是学…

2026/9/12 6:29:36

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/12 14:32:17

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/12 6:37:43

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码