nielsr HF Staff commited on
Commit
27bd919
·
verified ·
1 Parent(s): 748658c

Add model card for Reasoning Cache (RCT-4B)

Browse files

This PR adds a comprehensive model card for the `RCT-4B` model, which implements the Reasoning Cache (RC) algorithm.

Key improvements include:
- Added `pipeline_tag: text-generation` for better discoverability.
- Added `library_name: transformers` to enable the automated `transformers` code snippet, as the model architecture is compatible.
- Included relevant `tags` such as `reasoning`, `extrapolation`, `rl`, and `qwen`.
- Provided a clear model description based on the paper abstract.
- Linked to the official research paper: [Reasoning Cache: Continual Improvement Over Long Horizons via Short-Horizon RL](https://huggingface.co/papers/2602.03773).
- Added a link to the official GitHub repository: [IanYHWu/rc](https://github.com/IanYHWu/rc).
- Included a usage section explaining the need for RC-decoding logic, referencing vLLM for inference and verl for training, and clarifying `transformers` compatibility for loading.
- Added a BibTeX citation.

This enhanced model card provides essential information for users and improves the model's integration and discoverability on the Hugging Face Hub.

Files changed (1) hide show
  1. README.md +53 -0
README.md ADDED
@@ -0,0 +1,53 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ pipeline_tag: text-generation
3
+ library_name: transformers
4
+ tags:
5
+ - reasoning
6
+ - extrapolation
7
+ - rl
8
+ - qwen
9
+ ---
10
+
11
+ # Reasoning Cache (RCT-4B)
12
+
13
+ This repository contains the `RCT-4B` model checkpoint, a 4B parameter Large Language Model (LLM) trained using **Reasoning Cache (RC)**, as introduced in the paper [Reasoning Cache: Continual Improvement Over Long Horizons via Short-Horizon RL](https://huggingface.co/papers/2602.03773).
14
+
15
+ ## Model Description
16
+
17
+ Reasoning Cache (RC) is an iterative decoding algorithm that replaces standard autoregressive decoding during both training and inference. It exploits an asymmetry between the response generation and summarization capabilities of LLMs to construct reasoning chains that consistently improve across iterations.
18
+
19
+ Models trained to use RC can extrapolate and continually improve over reasoning horizons significantly longer than those seen during training. Empirically, `RCT-4B` demonstrates substantial performance gains on challenging benchmarks like HMMT 2025, outperforming both comparably sized models and many larger reasoning LLMs by effectively scaling test-time compute.
20
+
21
+ * **Developed by:** Ian Wu, Yuxiao Qu, Amrith Setlur, Aviral Kumar
22
+ * **Paper:** [Reasoning Cache: Continual Improvement Over Long Horizons via Short-Horizon RL](https://huggingface.co/papers/2602.03773)
23
+ * **Repository:** [GitHub - IanYHWu/rc](https://github.com/IanYHWu/rc)
24
+
25
+ ## Usage
26
+
27
+ This model can be loaded using the Hugging Face `transformers` library for standard model and tokenizer operations. However, to leverage the iterative `RC`-decoding algorithm and achieve the continual improvement and extrapolation capabilities described in the paper, specific inference logic must be applied.
28
+
29
+ For detailed instructions on using `RC`-decoding for inference (which currently supports `vLLM`) and for the training code (which requires `verl`), please refer to the [official GitHub repository](https://github.com/IanYHWu/rc).
30
+
31
+ ```python
32
+ # Example of loading the model with transformers (RC-decoding logic not included here)
33
+ from transformers import AutoTokenizer, AutoModelForCausalLM
34
+
35
+ model_name = "YOUR_REPO_ID_HERE" # Replace with the actual repository ID
36
+ tokenizer = AutoTokenizer.from_pretrained(model_name)
37
+ model = AutoModelForCausalLM.from_pretrained(model_name)
38
+
39
+ # For RC-decoding, please refer to the official GitHub repository's `inference` section.
40
+ ```
41
+
42
+ ## Citation
43
+
44
+ If you find this work useful, please cite the original paper:
45
+
46
+ ```bibtex
47
+ @article{wu2026reasoning,
48
+ title={Reasoning Cache: Continual Improvement Over Long Horizons via Short-Horizon RL},
49
+ author={Wu, Ian and Qu, Yuxiao and Setlur, Amrith and Kumar, Aviral},
50
+ journal={arXiv preprint arXiv:2602.03773},
51
+ year={2026}
52
+ }
53
+ ```