open-r1
FreeFully open reproduction of DeepSeek-R1
About open-r1
Open R1 is an open-source project by Hugging Face aimed at fully reproducing DeepSeek-R1, an advanced reasoning model. The repository provides scripts for training models using GRPO (Group Relative Policy Optimization) and SFT (Supervised Fine-Tuning), as well as generating synthetic data with Distilabel. The project follows a three-step plan: distilling a high-quality corpus from DeepSeek-R1 to create R1-Distill models, replicating the pure RL pipeline for R1-Zero using curated datasets for math, reasoning, and code, and demonstrating multi-stage training from a base model to RL-tuned. As of May 2025, Step 1 has been completed with the release of the Mixture-of-Thoughts dataset (350k verified reasoning traces) and a recipe for OpenR1-Distill-7B, which matches DeepSeek’s distilled model performance. Additional released datasets include CodeForces-CoTs and OpenR1-Math-220k. The project is community-driven and a work in progress, requiring CUDA 12.4 and Python with uv for setup.
Key Features
Pros & Cons
- Completely open-source, allowing full transparency and community contributions
- Releases verified training datasets and model recipes to accelerate research
- Actively maintained with frequent updates and clear roadmap
- Leverages Hugging Face ecosystem and existing tools like transformers and accelerate
- Provides reproducible training scripts (GRPO, SFT) with minimal dependencies
- Work in progress – not all steps of DeepSeek-R1 replication are completed yet
- Requires CUDA 12.4 and specific GPU hardware for training
- Dependency on proprietary DeepSeek-R1 model for distillation data generation
- Limited documentation and setup instructions for non-expert users