llama factory安装_llama factory window conda 安装
要在 Windows 或 Linux 上使用 **Conda** 安装 [LLaMA Factory](https://github.com/hiyouga/LLaMA-Factory)，你可以按照以下步骤操作。LLaMA Factory 是一个基于 Hugging Face Transformers 的多模型训练和推理框架，支持 LLaMA、ChatGLM、Baichuan 等多种大语言模型。
---
## 📦 一、准备工作
### ✅ 1. 安装 Conda（如果还没安装）
如果你还没有安装 Conda，可以下载：
- **Anaconda**：功能完整但体积较大
👉 https://www.anaconda.com/products/distribution
- **Miniconda**（推荐）：轻量级，只安装基础环境
👉 https://docs.conda.io/en/latest/miniconda.html
---
## 🧱 二、创建并激活 Conda 虚拟环境
```bash
conda create -n llama_factory python=3.10
conda activate llama_factory
```
---
## 📥 三、安装 LLaMA Factory（方法一：从源码安装）
这是最常见也是推荐的方式，适合需要自定义配置或调试的用户。
### ✅ 步骤如下：
#### 1. 克隆项目仓库
```bash
git clone https://github.com/hiyouga/LLaMA-Factory.git
cd LLaMA-Factory
```
> 如果你无法访问 GitHub，可以使用 Gitee 镜像：
>
> ```bash
> git clone https://gitee.com/hiyouga/llama-factory.git
> cd llama-factory
> ```
#### 2. 安装依赖
```bash
pip install -r requirements.txt
```
> 如果你在国内，建议使用清华镜像加速安装：
>
> ```bash
> pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
> ```
#### 3. 安装本地包（可选）
有些模块是本地包（如 `llamafactory`），可以使用：
```bash
pip install -e .
```
---
## ▶️ 四、启动 Web UI
安装完成后，运行以下命令启动本地 Web 界面：
```bash
python src/webui.py
```
然后在浏览器中打开：
```
http://localhost:8000
```
你就可以开始训练或推理了！
---
## 📦 方法二：使用 PyPI 安装（简化方式）
如果你不想从源码构建，也可以直接通过 pip 安装官方发布的版本（适用于只想快速使用）：
```bash
pip install llamafactory
```
然后同样运行：
```bash
python -m llamafactory.webui
```
---
## 🧠 可选：安装 CUDA 支持（GPU 加速）
确保你的系统有 NVIDIA GPU，并已安装合适的驱动和 CUDA Toolkit。
```bash
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
```
或者根据你的 CUDA 版本选择对应的安装命令：
👉 https://pytorch.org/get-started/locally/
---
## 💡 常见问题与解决办法
| 问题 | 解决方案 |
|------|----------|
| 报错 `ModuleNotFoundError` | 检查是否执行过 `pip install -e .` |
| 启动失败提示端口占用 | 更改 `webui.py` 中的端口号 |
| 页面打不开 | 关闭防火墙或检查端口监听情况 |
---
## ✅ 总结
| 步骤 | 命令 |
|------|------|
| 创建虚拟环境 | `conda create -n llama_factory python=3.10` |
| 激活环境 | `conda activate llama_factory` |
| 克隆项目 | `git clone https://github.com/hiyouga/LLaMA-Factory.git` |
| 安装依赖 | `pip install -r requirements.txt` |
| 安装本地包 | `pip install -e .` |
| 启动界面 | `python src/webui.py` |
---
如果你遇到具体错误或想指定某个模型（如 LLaMA3、ChatGLM3、Baichuan2 等），欢迎继续提问，我可以帮你定制安装流程 😄
