Repository-to-RLenv

Repository-to-RLenv turns a Python repo into a live RL coding environment.

Install

pip install -e .

If you use Claude Code, register the MCP server:

claude mcp add --scope user repo2env -- .venv/bin/repo2env-mcp

Use

Open the target repo in Claude Code and run:

/mcp__repo2env__convert_to_rl_env

One command kicks off the full conversion workflow.

Inference

You can also run Repo2Env locally:

repo2env-openenv-server --port 8000

Smoke test a local or HF-hosted env:

repo2env-smoke-test --base-url http://127.0.0.1:8000

Run inference against an env:

repo2env-infer \
  --base-url https://tema7707-repo2env-toolz.hf.space \
  --model gpt-4o-mini \
  --model gpt-5 \
  --temperature 1 \
  --output toolz_infer_debug.json

How It Works

Current one-command MCP workflow:

start Claude Code
  ->
run /mcp__repo2env__convert_to_rl_env
  ->
AUTOMATIC: inspect repo structure and tests
  ->
AUTOMATIC: copy repo to /tmp/repo2env-<repo>-bug-<variant>-staged
  ->
AUTOMATIC: Claude introduces one small source-code bug in the staged copy
  ->
AUTOMATIC: rerun scoped tests to confirm the bug actually fails
  ->
AUTOMATIC: write task_spec.json on the staged copy
  ->
AUTOMATIC: Repo2Env analyze_repo on staged copy
  ->
AUTOMATIC: Repo2Env convert_repo on staged copy
  ->
AUTOMATIC: openenv validate
  ->
AUTOMATIC: openenv push
  ->
HF Space with live RL env

Training

Minimal GRPO training script using Unsloth + TRL on collected Repo2Env trajectories. Runs on a free T4 GPU in Google Colab.

Live Collection

• Repository to RLEnv collection
• tema7707 Spaces

Converted Envs

Source repo	Stars	Hugging Face Space	Claude conversation
psf/requests	53,862	Atemii/repo2env-repo2env-requests-bug-1-staged	requests.txt
pallets/click	17,343	Atemii/repo2env-repo2env-click-bug-1-staged	click.txt
pytoolz/toolz	5,120	tema7707/repo2env-toolz	—
pytoolz/toolz	5,120	tema7707/repo2env-toolz-bug-0	toolz.txt
more-itertools/more-itertools	4,041	tema7707/repo2env-repo2env-more-itertools-bug-intersperse-staged	more-itertools.txt
mahmoud/glom	2,128	tema7707/repo2env-repo2env-glom-bug-mutation-staged	glom.txt
pytest-dev/pluggy	1,581	Atemii/repo2env-repo2env-pluggy-bug-ordering-staged	pluggy.txt
python-humanize/humanize	709	tema7707/repo2env-repo2env-humanize-bug-intword-staged	—
h2non/pook	368	tema7707/repo2env-pook	—
matsui528/nanopq	360	tema7707/repo2env-repo2env-nanopq-bug-decode-staged	nanopq.txt
psolin/cleanco	351	tema7707/repo2env-repo2env-cleanco-bug-strip-tail-staged	cleanco.txt
scrapinghub/number-parser	127	tema7707/repo2env-repo2env-number-parser-bug-1-staged	number-parser.txt