CoolFace
Modelpublic

OpenHands/CodeScout-14B

sourceHugging Faceapache-2.0updated 6mo agoView on Hugging Face
4likes122downloads
Model Card

CodeScout-14B

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

Strongest CodeScout model โ€” open-source SOTA on SWE-Bench code localization.

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

CodeScout-14B 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

  • โ€”Open-source SOTA on SWE-Bench Verified, Pro, and Lite for code localization
  • โ€”Outperforms 2โ€“18ร— larger base and post-trained LLMs across all benchmarks
  • โ€”Surpasses GPT-5 and approaches Claude Sonnet 4.5 using RepoNavigator, despite using only a bash terminal
  • โ€”Achieves 8โ€“33% higher function-level F1 than Qwen3-32B (Thinking)

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-14B is trained directly from Qwen3-14B using GSPO (Group Sequence Policy Optimization) reinforcement learning.

  • โ€”Training data: 9,600 instances from SWE-Smith (39K filtered, 128 repos)
  • โ€”RL steps: 300
  • โ€”Batch size: 32, with 4 rollouts per instance
  • โ€”Max context length: 50K tokens (extended with YaRN)
  • โ€”Max turns per episode: 4
  • โ€”Reward: Multi-level F1 (file + module + function) with auxiliary turn-completion reward
  • โ€”Hardware: 8ร—H100 GPUs
  • โ€”Learning rate: 1e-6 (constant)

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-14B 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}, 
}