reasoning-from-scratch

从零手写推理模型,彻底搞懂 o1 原理

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 939 🐛 待处理 2 👀 关注 67
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 5814
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0 许可证,完全免费,无付费版本。

项目预览

reasoning-from-scratch 项目界面预览图
图片来源:项目官网

项目数据

分类开源模型
开发团队rasbt
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0 许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Jupyter Notebook
技术栈/模型ai,artificial-intelligence,chain-of-thought,deep-learning,distillation,grpo,inference-time-scaling,large-language-models,llm,llms,machine-learning,math-reasoning,python,pytorch,reasoning,reasoning-models,reinforcement-learning,rlhf,test-time-compute
GitHub 星标★ 5814
上线时间2025-03-04 00:00:00
代码更新2026-11-02
仓库体积5.3 MB
本站数据更新2026-11-10
维护状态较活跃
收录时间2026-08-09
浏览次数5

项目介绍

reasoning-from-scratch 是一个从零开始实现推理大语言模型(LLM)的开源教程项目,基于 PyTorch 逐步构建。它旨在帮助开发者和研究者深入理解推理模型(如 o1 类模型)的内部工作原理,通过代码和文档拆解强化学习、思维链、奖励建模等关键环节。项目解决了当前推理模型黑盒化、难以定制的问题,让用户能够亲手训练一个具备基础推理能力的模型。核心能力包括:提供完整的模型架构、训练脚本、数据生成流程,以及详细的 Jupyter Notebook 讲解,覆盖从数据准备到强化学习微调的全链路。用户可以通过该项目学习如何设计奖励函数、应用策略梯度算法,并最终得到一个可运行的推理模型。项目代码结构清晰,适合作为教学和实验基础,也支持在此基础上进行二次开发。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5814

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:进阶 约 10 分钟 部署方式:本地安装 4 步

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

环境要求

  • 可访问 GitHub 的网络环境(用于克隆仓库)
  • Python 3 环境(项目为 Jupyter Notebook 代码,README 未指定版本)
  • 可运行 .ipynb 的 Jupyter 环境
  • 阅读官方书籍《Build a Reasoning Model (From Scratch)》以便对照章节代码

安装与启动步骤

  1. 1克隆代码仓库

    从 GitHub 获取本项目官方源码,README 给出的源码仓库即为该地址,克隆到本地即可。

    git clone https://github.com/rasbt/reasoning-from-scratch.git
  2. 2进入项目目录

    切换到克隆下来的仓库目录,后续所有操作都在该目录内进行。

    cd reasoning-from-scratch
  3. 3查看官方书籍页面

    README 指向 Manning 书籍页面(https://mng.bz/lZ5B),代码与书中章节一一对应,建议先浏览目录。

  4. 4打开 Jupyter 阅读代码

    仓库为 Jupyter Notebook 项目,用 Jupyter 打开 .ipynb 文件按章节阅读和运行,README 未提供依赖安装命令。

    jupyter notebook

如何确认成功

能成功克隆仓库,并在 Jupyter 中打开仓库内的 .ipynb 文件即视为准备完成(README 未给出运行验证方式)。

常见问题

Q:必须买书才能用这个仓库吗?

A:README 说明本仓库是《Build a Reasoning Model (From Scratch)》的官方配套代码,并给出 Manning 书籍链接,建议结合书籍章节学习效果最好。

Q:README 里有安装依赖的命令吗?

A:节选中没有任何 pip/conda 安装命令或依赖清单,因此本教程未编造安装步骤,请以仓库内实际文件与书籍内容为准。

Q:这个项目能直接训练出推理模型吗?

A:README 说明书中方法用于教育目的,从预训练基础模型出发,用代码一步步添加推理能力,并包含加载已有预训练模型权重的代码。

Q:对硬件有什么要求?

A:README 未说明硬件要求;书中定位是 small-but-functional 的教学模型,实际显存/算力取决于所选章节与模型规模。

注意事项

  • README 节选未包含环境搭建与依赖安装说明,以上步骤仅为获取仓库与阅读准备,confidence 为 low
  • 仓库代码与书籍章节配套,建议对照书籍逐步推进
  • 不要凭猜测安装 README 未列出的第三方包或指定未知端口、路径

核心亮点

  • 从零搭建完整推理模型,代码逐行讲解,学习路径清晰
  • 覆盖强化学习、思维链等核心环节,实战性强
  • 基于 PyTorch,易于复现和二次开发,社区活跃

不足之处

  • 文档/社区待观察
  • 教程项目,模型规模有限,生产环境适用性待验证

适用场景

  • 深度学习研究者快速入门推理模型
  • 工程师在私有环境定制轻量推理能力
  • 教学场景中作为 LLM 原理的实践教材

替代项目

Karpathy/nanoGPT、huggingface/transformers、OpenRLHF

上一篇:EasyR1

下一篇:llm-foundry

同类项目推荐

DreamBooth 开源

用几张照片,让AI学会画你的专属对象

This repository contains the implementation of DreamBooth with Stable Diffusion. You···

★ 61 2026-08-09
AlphaEdit 开源

不改模型结构,精准修改大模型知识,性能不塌方

AlphaEdit: Null-Space Constrained Knowledge Editing for Language Models, ICLR 2025 (···

★ 469 2026-08-09
MLX-LoRA-Studio 开源

Mac 上点几下就完成大模型 LoRA 微调,数据不出本机

A native Mac App for LLM fine-tuning on Apple Silicon — fully on-device, fully open···

★ 289 2026-09-16
WaDi 开源

一步生成高质量图像,蒸馏时精准把控权重方向

[CVPR 2026] Official PyTorch implementation of WaDi: Weight Direction-aware Distilla···

★ 128 2026-08-09
ml-engineering 开源

大模型训练推理踩坑指南,照着调优省半年时间

Machine Learning Engineering Open Book

★ 19692 2026-08-09
mergekit 开源

拖拽式合并大模型,轻松融合多个模型能力

Tools for merging pretrained large language models.

★ 7442 2026-08-09
safetensors_util 开源

轻松管理 Safetensors 模型,玩转 Stable Diffusion 与 LoRA

Utility for Safetensors Files

★ 102 2026-08-09
verl-omni 开源

给扩散和全模态模型做 RL 后训练,一套框架跑通

Multimodal RL training framework for diffusion & omni models

★ 1485 2026-10-12