debug_env/README.md

debug_env — Python Package

This directory is the debug_env Python package. See the root README for full documentation.

Package Contents

Module	Description
models.py	DebugAction, DebugObservation Pydantic models
client.py	DebugEnv HTTP/WebSocket client
server/	FastAPI server — the benchmark environment
tasks/	Task source files (task1–task9)
rl/	GRPO training utilities (dataset, rollout)

Quick usage

from debug_env import DebugAction, DebugObservation
from debug_env.client import DebugEnvClient

client = DebugEnvClient(base_url="http://localhost:8000")
obs = client.reset(task="task1")
result = client.step(DebugAction(tool="list_files", args={}))

Running the server

# From repo root
uv run server

Server exposes GET /health, POST /reset, POST /step, GET /tasks, POST /mcp, /web, /docs.