notebooks

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 可运行 Jupyter Notebook 的环境（本地 Jupyter 或 Google Colab）
• 用于模型微调训练的 GPU 环境
• 能访问 GitHub / Google Colab 的网络（用于拉取仓库与在线运行）

安装与启动步骤

1. 1获取 Notebook 合集

   从 GitHub 克隆 Unsloth 官方 notebooks 仓库到本地，README 中未给出额外安装脚本，克隆后即可看到按模型分类的 .ipynb 文件。

   git clone https://github.com/unslothai/notebooks.git

   复制

2. 2挑选目标模型 Notebook

   在仓库中按模型名找到对应的 Notebook，每个 Notebook 针对具体模型和任务写好了完整流程，无需自己拼装训练代码。

3. 3线上快速运行（可选）

   README 提供了 Colab 直达按钮，也可直接在浏览器打开对应 Notebook 链接，免去本地环境配置。

   https://colab.research.google.com/github/unslothai/notebooks/blob/main/nb/gpt-oss-(20B)-Fine-tuning.ipynb

   复制

4. 4替换数据集路径

   按 README 说明，Notebook 内已包含数据准备、训练与推理三步，用户通常只需把数据集路径改为自己的数据即可运行。

5. 5依次执行单元格

   在 Jupyter 或 Colab 中自上而下执行单元格，完成数据准备、模型训练与推理验证；报错时可对照官方文档排查。

如何确认成功

Notebook 单元格自上而下执行无报错，并能完成一次数据准备、训练与推理输出，即视为运行成功。

常见问题

注意事项

• Notebook 会持续更新，建议以 README 与官网文档中列出的版本为准。
• 不同模型对应不同 Notebook，请先确认模型名称再选择文件。
• 文档站 https://unsloth.ai/docs 提供了微调指南，可配合 Notebook 一起阅读。