跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

LLaMA-Factory 详细安装教程

LLaMA-Factory 是大语言模型微调工具。在 WSL Ubuntu 环境下,需先确认 GPU 支持 CUDA 并安装 GCC。通过 Conda 管理 Python 环境,安装指定版本的 PyTorch 与 CUDA 驱动。随后克隆 LLaMA-Factory 仓库并安装依赖包。完成后可通过命令校验版本,启动 WebUI 实现可视化零代码微调。注意默认访问地址仅限本机,联网部署需内网穿透。

CryptoLab发布于 2026/3/21更新于 2026/8/2441 浏览
LLaMA-Factory 详细安装教程

环境准备

  • 显卡:双 RTX 3090
  • 系统:WSL Ubuntu
  • Python: 3.12.4
  • Conda: 24.5.0
  • CUDA: 12.4
  • PyTorch: 2.6.0

一、准备工作

首先,在 https://developer.nvidia.com/cuda-gpus 查看您的 GPU 是否支持 CUDA。

保证当前 Linux 版本支持 CUDA。在命令行中输入:

uname -m && cat /etc/*release

输出如下,不一定完全一样,类似即可:

文章配图

检查是否安装了 gcc。在命令行中输入 gcc --version,应当看到类似的输出:

文章配图

二、PyTorch 和 CUDA 安装

使用官网版本 2.6.0,官网链接:Previous PyTorch Versions,箭头一栏可以看到历史版本。

文章配图

文章配图

根据其指令安装对应版本:

# ROCM 6.1 (Linux only)
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/rocm6.1

# ROCM 6.2.4 (Linux only)
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/rocm6.2.4

# CUDA 11.8
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/cu118

# CUDA 12.4
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/cu124

# CUDA 12.6
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/cu126

# CPU only
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 --index-url https://download.pytorch.org/whl/cpu

三、校验 PyTorch 和 CUDA 版本

安装完查看自己的 PyTorch 版本:

conda list

文章配图

CUDA 版本则需要进入 Python:

import torch
print(torch.version.cuda)

文章配图

四、LLaMA-Factory 安装

运行以下指令以安装 LLaMA-Factory 及其依赖:

git clone --depth 1 https://github.com/hiyouga/LLaMA-Factory.git
cd LLaMA-Factory
pip install -e ".[torch,metrics]"

五、LLaMA-Factory 校验

完成安装后,可以通过使用以下命令:

llamafactory-cli version

如果您能成功看到类似下面的界面,就说明安装成功了:

文章配图

六、LLaMA-Factory 网页版

LLaMA-Factory 支持通过 WebUI 零代码微调大语言模型。在完成安装后,通过以下指令进入 WebUI:

llamafactory-cli webui

文章配图

其中 http://127.0.0.1:7860 就是你的可视化网址。

注:该网址只限于本机使用,如需联网多人服务器使用则需使用内网穿透。

目录

  1. 环境准备
  2. 一、准备工作
  3. 二、PyTorch 和 CUDA 安装
  4. ROCM 6.1 (Linux only)
  5. ROCM 6.2.4 (Linux only)
  6. CUDA 11.8
  7. CUDA 12.4
  8. CUDA 12.6
  9. CPU only
  10. 三、校验 PyTorch 和 CUDA 版本
  11. 四、LLaMA-Factory 安装
  12. 五、LLaMA-Factory 校验
  13. 六、LLaMA-Factory 网页版
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Web 前端基础:HTML 核心语法与常用标签
  • 火山引擎发布两款视频大模型及多项 AI 升级
  • Cursor、Kiro 与 Google Antigravity:AI 编程工具对比分析
  • OpenClaw 实战部署:从环境搭建到自动化工作流配置指南
  • SQL Server 2019 安装与配置指南
  • Lostlife2.0 角色对话系统升级:基于 LLama-Factory 微调剧情模型
  • 哈希桶的开散列模拟实现
  • Criminisi 图像修复算法 MATLAB 实现详解
  • C++ STL 手写 String 类实现及高频易错点复盘
  • CMS 模板注入导致前台 RCE 漏洞挖掘与修复分析
  • Java 后端 Web API 开发实战:基于 Spring Boot 的全流程指南
  • Z-Image-Turbo Python API 调用示例详解
  • Python 调用通义千问 Qwen2.5 模型完整流程
  • 基于 Vue+Flask+Neo4j 的中医中药知识智能问答与图谱构建系统
  • 利用 AI 快速构建 Windows 18-HD19 风格 CSS 组件库
  • VS Code 配置 Python 开发环境指南
  • XDMA 与 FPGA DMA 控制器协同设计详解
  • Llama-2-7b 昇腾 NPU 测评:性能数据、场景适配与硬件选型
  • 深圳机器人公司概览:人形、工业与自动驾驶企业名单
  • HTML 核心语法与常用标签入门指南

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online