CoolFace
Modelpublic

OpenHands/CodeScout-1.7B-RFT

sourceHugging Faceapache-2.0updated 6mo agoView on Hugging Face
1likes26downloads
Model Card

CodeScout-1.7B-RFT

๐Ÿ“„ Paper โ€ข ๐Ÿ’ป Code โ€ข ๐Ÿค— Collection

Pre-RL checkpoint โ€” rejection fine-tuned on expert trajectories from CodeScout-14B.

<p align="center"> <img src="codescout_overview.png" alt="CodeScout Overview" width="100%"> </p>

CodeScout-1.7B-RFT is part of the CodeScout family of open-source RL-trained code search agents. CodeScout models achieve state-of-the-art repository-level code localization using nothing more than a standard Unix terminal โ€” no static analysis, no repository graphs, no language-specific tooling.

Key Highlights

  • โ€”Warm-start checkpoint for CodeScout-1.7B RL training
  • โ€”Distilled from CodeScout-14B expert trajectories with rejection sampling
  • โ€”Useful for researchers studying the effect of RFT vs. RL in agent training pipelines
  • โ€”Can be used as a base for custom RL experiments on code search

Results

Performance on SWE-Bench code localization (instance-averaged F1 scores):

BenchmarkCodeScout-1.7BCodeScout-4BCodeScout-14B
SWE-Bench Verified โ€” File F155.4668.5268.57
SWE-Bench Verified โ€” Func F128.2236.7840.32
SWE-Bench Pro โ€” File F140.9651.7753.63
SWE-Bench Pro โ€” Func F118.2429.0328.74
SWE-Bench Lite โ€” File F156.5767.0371.84
SWE-Bench Lite โ€” Func F127.0739.8744.43

<p align="center"> <img src="f1vsparamsfile.png" alt="File-level F1 vs Model Size" width="48%"> <img src="f1vsparamsfunction.png" alt="Function-level F1 vs Model Size" width="48%"> </p>

<p align="center"><em>Code localization performance on SWE-Bench Verified. CodeScout (โญ) achieves superior or competitive results over larger open-source LLMs and narrows the gap with closed-source frontier models.</em></p>

Training

CodeScout-1.7B-RFT is the intermediate checkpoint produced by rejection fine-tuning (RFT) Qwen3-1.7B on expert trajectories from CodeScout-14B, before the final RL stage.

  • โ€”Teacher model: CodeScout-14B
  • โ€”Source trajectories: Rollouts from CodeScout-14B on 7,700 training instances
  • โ€”Filtered data: 4K trajectories with perfect scores (F1 = 1.0 at file, module, and function level)
  • โ€”SFT epochs: 1
  • โ€”Learning rate: 5e-5 with cosine scheduler (warmup ratio 0.1)
  • โ€”Batch size: 8
  • โ€”Optimizer: AdamW
  • โ€”Framework: veRL

This checkpoint serves as the starting point for RL training of CodeScout-1.7B.

How It Works

CodeScout uses the OpenHands-Bash scaffold โ€” an agent equipped with only a Terminal tool (supporting standard Unix commands like rg, find, grep, ls) and a LocalizationFinish tool for structured output submission. The agent iteratively navigates the repository to identify relevant files, classes, and functions related to a given issue.

The model is trained with GSPO (Group Sequence Policy Optimization) using multi-level F1 rewards at the file, module, and function level.

Intended Use

CodeScout-1.7B-RFT is designed for repository-level code localization: given a GitHub issue description and a code repository, it identifies the relevant files, classes, and functions that need to be modified. It is intended to be used as a localization subagent within larger coding agent pipelines.

Limitations

  • โ€”Trained and evaluated exclusively on Python repositories
  • โ€”Designed for code localization, not code editing or issue resolution
  • โ€”Performance may vary on repositories significantly different from the training distribution
  • โ€”Requires the OpenHands-Bash scaffold for optimal performance

Citation

bibtex
@misc{sutawika2026codescouteffectiverecipereinforcement,
      title={CodeScout: An Effective Recipe for Reinforcement Learning of Code Search Agents}, 
      author={Lintang Sutawika and Aditya Bharat Soni and Bharath Sriraam R R and Apurva Gandhi and Taha Yassine and Sanidhya Vijayvargiya and Yuchen Li and Xuhui Zhou and Yilin Zhang and Leander Melroy Maben and Graham Neubig},
      year={2026},
      eprint={2603.17829},
      archivePrefix={arXiv},
      primaryClass={cs.SE},
      url={https://arxiv.org/abs/2603.17829}, 
}