# FineTuneX 安装指南

## 系统要求

- **Python**: 3.9 或更高版本
- **操作系统**: Windows 10/11, Linux, macOS
- **GPU** (可选但推荐): NVIDIA GPU with 8GB+ VRAM, CUDA 11.7+

## 当前环境问题

检测到你当前使用的 Python 版本是 3.5.4，这太旧了，无法运行 FineTuneX。

### 解决方案

1. **安装 Python 3.9+**
   
   Windows 用户:
   - 从 python.org 下载 Python 3.9 或更高版本
   - 安装时勾选 "Add Python to PATH"
   
   或者使用 Anaconda:
   ```bash
   conda create -n finetunex python=3.9
   conda activate finetunex
   ```

2. **创建虚拟环境** (推荐)
   
   ```bash
   # 使用 venv
   python -m venv venv
   venv\Scripts\activate  # Windows
   source venv/bin/activate  # Linux/Mac
   
   # 或使用 conda
   conda create -n finetunex python=3.9
   conda activate finetunex
   ```

3. **安装依赖**
   
   ```bash
   pip install --upgrade pip
   pip install -r requirements.txt
   ```

## 验证安装

```bash
python scripts/check_env.py
```

## 快速测试

```bash
python -c "import torch; print('PyTorch:', torch.__version__)"
python -c "import transformers; print('Transformers:', transformers.__version__)"
```

## 常见问题

### Q: 为什么需要 Python 3.9+？

A: FineTuneX 使用了 Python 3.9+ 的特性，如：
- f-strings (虽然在 3.6+ 就引入了)
- 新的类型提示语法
- 最新的语言特性

### Q: 我可以只使用 CPU 吗？

A: 可以，但训练速度会慢很多。建议使用 GPU 或云平台 (Google Colab, Kaggle)。

### Q: 显存不足怎么办？

A: 可以尝试：
1. 使用 4bit 量化：`use_4bit=True`
2. 减小批次大小
3. 减小序列长度
4. 使用梯度累积

## 云平台选项

如果本地没有合适的 GPU，可以使用：

1. **Google Colab** (免费 T4 GPU)
   - 上传项目到 Google Drive
   - 使用 examples/colab_example.py

2. **Kaggle Kernels** (免费 P100 GPU)

3. **AutoDL** (国内，性价比高)

## 下一步

安装完成后，运行:

```bash
python examples/qwen3.5_0.8b_finetune.py
```

祝你使用愉快！