| --- |
| title: Code Review Agent Environment |
| sdk: docker |
| app_port: 7860 |
| --- |
| |
| # Code Review Agent Environment |
|
|
| Submission for the Meta x Hugging Face OpenEnv Hackathon. |
|
|
| Authors / Members: |
| - Ashish |
| - Shardul |
| - Harshit |
|
|
| ## Overview |
|
|
| This project is a real-world code review environment for AI agents. The agent receives a code diff plus surrounding context and must identify issues, suggest fixes, and decide whether changes should be approved or rejected. |
|
|
| ## Live Section |
| Live Space: [huggingface.co/spaces/Spirit-26/code-review-environment](https://huggingface.co/spaces/Spirit-26/code-review-environment) |
|
|
| ## Core Features |
|
|
| - OpenEnv-style `reset()`, `step()`, and `state()` API |
| - Pydantic-based action, observation, and state models |
| - 6 review tasks across easy, medium, and hard difficulty |
| - Deterministic graders with scores from `0.0` to `1.0` |
| - Reward shaping for partial progress and invalid actions |
| - Docker support and Hugging Face Space deployment |
| - Baseline inference script at the repository root: `inference.py` |
|
|
| ## Required Environment Variables |
|
|
| Use an OpenAI-compatible endpoint. |
|
|
| - `API_BASE_URL` |
| - `MODEL_NAME` |
| - `API_KEY` |
|
|
| Backward-compatible aliases are also supported: |
|
|
| - `HF_TOKEN` |
| - `OPENAI_API_KEY` |
|
|
| ## Local Run |
|
|
| ```bash |
| python -m venv .venv |
| .\.venv\Scripts\Activate.ps1 |
| pip install -r requirements.txt |
| python inference.py --task-id bug_detection_easy_1 --max-steps 50 --output baseline_results.json |
| ``` |
|
|
| ## Validation |
|
|
| ```bash |
| python submit.py |
| ``` |
|
|
| ## Docker |
|
|
| ```bash |
| docker build -t code-review-openenv . |
| docker run --rm -p 7860:7860 \ |
| -e API_BASE_URL=https://api.openai.com/v1 \ |
| -e MODEL_NAME=gpt-4o-mini \ |
| -e API_KEY=<your_key> \ |
| code-review-openenv |
| ``` |
|
|
