FineTurnX/INSTALL.md

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:

   conda create -n finetunex python=3.9
   conda activate finetunex

1. 创建虚拟环境 (推荐)

   # 使用 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
   

2. 安装依赖

   pip install --upgrade pip
   pip install -r requirements.txt
   

验证安装

python scripts/check_env.py

快速测试

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 (国内，性价比高)

下一步

安装完成后，运行:

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

祝你使用愉快！