⚠️WARNING⚠️: New Qwen3 base models have untrained token embeddings, we used python absolute_zero_reasoner/utils/remove_think_qwen3_tokenizer.py --model_name <Qwen3ModelName> to remove these tokens or else the model produces nonsense.

🚧UNDER TESTING🚧 This new merge to main is still under testing. Use the paper branch to replicate results from original paper.

• [2025/06/30] We now support Sandbox-Fusion as executor, just put azr.executor=sandboxfusion in training configs. Officially completed our initial roadmap.
• [2025/06/28] We now support new version of veRL, use the paper branch to reproduce the paper results with static copy of veRL. The main branch will now be regularly updated with the latest veRL versions.
• [2025/06/01] We release code for evals
• [2025/05/06] We present the Absolute Zero Reasoner [Project Page | Paper | Code | Model(s) | Logs].

• 🏠 [Project Page]
• 📜 [Paper]
• 🤗 [Models]
• 💻 [Code]
• 📁 [Logs]

Our approach centers on a repeated iterative process of the following two steps:

1. PROPOSE: The model generates reasoning tasks from abduction, deduction, and induction types. Tasks are validated with Python execution and assigned a learnability reward.

2. SOLVE: The model then attempts to solve these self-generated tasks. Solutions are verified through Python execution, receiving an accuracy reward.

The model continuously improves through both phases using TRR++, creating a self-evolving loop that strengthens reasoning without external training data.

Main Results

Our approach achieves strong performance across both code and math reasoning benchmarks without using any external data:

Scaling Results

AZR shows consistent improvements across model sizes and types:

🎄 Environment Setup

conda env create -f azr_env.yml
conda activate azr
pip install -r flashattn_requirements.txt

💾 Data Processing

Process evaluation data on CruxEval / LiveCodeBench Execution during AZR Self-play

python -m absolute_zero_reasoner.data_construction.process_code_reasoning_data

⚠️WARNING⚠️: The Python executor in this repository is very raw and intended for research purposes only. It is not secure for production environments. We plan to update our executor to more secure implementations in the future. Your use of our code is at your own discretion and risk.

🫛 Seeding (Optional)

We provide the seed datasets we collected by prompting each model in data/. If you want to create your own seed data, use the following script:

export OUTPUT_SEED_PATH=data/<new_ded_abd_seed_data_name>.jsonl
export OUTPUT_CODE_F_SEED_PATH=data/<new_ind_seed_data_name>.jsonl
bash scripts/seeding/<7b|14b|coder3b|coder7b|coder14b|llama>.sh

♟️ Self-play

3b models need 2 X 80gb GPUs, 7/8b models need 4 X 80gb, 14b requires 8 X 80gb

bash scripts/selfplay/<7b|14b|coder3b|coder7b|coder14b|llama>.sh

If you want to use your own ded/abd or ind seed dataset:

export OUTPUT_SEED_PATH=data/<your_ded_abd_seed_data_name>.jsonl
export OUTPUT_CODE_F_SEED_PATH=data/<your_ind_seed_data_name>.jsonl
bash scripts/selfplay/<7b|14b|coder3b|coder7b|coder14b|llama>.sh

For using the newly supported sandbox-fusion executor, use docker and set azr.executor=sandboxfusion.

🌚 Resuming Runs

When resuming runs, put the original run wandb id into the script, i.e., trainer.wandb_run_id=<run_id>.

🤗 Converting veRL checkpoints to HF format

python -m absolute_zero_reasoner.utils.convert2hf \
  <veRL_ckpt_path>/actor \
  <veRL_ckpt_path>/actor/huggingface/ \
  <hf_ckpt_path>

📈Design Your Own Intrinsic Rewards!

In configs, just add your own rewards to azr.reward.generation_reward_config, check the ones already implemented such as diversity and complexity rewards. Be Creative!

We use the Deepseek R1 & tags as prompt template:

A conversation between User and Assistant. The user asks a question, and the Assistant solves it. The assistant first thinks about the reasoning process in the mind and then provides the user with the answer. The reasoning process and answer are enclosed within <think> </think> and <answer> </answer> tags, respectively, i.e., <think> reasoning process here </think> <answer> answer here </answer>. User: {question}\nAssistant: <think>

LiveCodeBench

Setup: LCB needs to first download the data

git clone https://hf-mirror.com/datasets/livecodebench/code_generation_lite evaluation/code_eval/coding/LiveCodeBench/code_generation_lite

Evaluation:

bash evaluation/code_eval/scripts/run_lcb_gen.sh --model <andrewzh/Absolute_Zero_Reasoner-Coder-3b>

Evalplus

New conda env is neede for evalplus

conda create -n evalplus python=3.11
pip install --upgrade "evalplus[vllm] @ git+https://github.com/evalplus/evalplus@d362e933265c3e7e3df8101c930a89c3c470cd9f"
Evaluation:
```bash
condda activate evalplus
bash evaluation/code_eval/scripts/run_evalplus.sh 0 <humaneval|mbpp> <andrewzh/Absolute_Zero_Reasoner-Coder-3b>

Math

Please refer to evaluation/math_eval/README.md for math evaluation.

If you find Absolute Zero Reasoner helpful, please cite us.

@misc{zhao2025absolutezeroreinforcedselfplay,
      title={Absolute Zero: Reinforced Self-play Reasoning with Zero Data}, 
      author={Andrew Zhao and Yiran Wu and Yang Yue and Tong Wu and Quentin Xu and Yang Yue and Matthieu Lin and Shenzhi Wang and Qingyun Wu and Zilong Zheng and Gao Huang},
      year={2025},
      eprint={2505.03335},
      archivePrefix={arXiv},
      primaryClass={cs.LG},
      url={https://arxiv.org/abs/2505.03335}, 
}

Our reinforcement learning training codebase is a fork of the veRL framework. For rollouts, we used vLLM. The Python executor components are adapted from the QwQ Repository. Additionally, we borrowed our README structure from PRIME. Many thanks to the authors of these projects for their excellent contributions!

Feel free to contact Andrew Zhao via email: zqc21@mails.tsinghua.edu.cn