Team Ai
Apppublic

pdevyani/dev-assistant-env

sourceHugging Faceupdated 6mo agoView on Hugging Face
0likes
App README

Dev Assistant OpenEnv Environment

๐Ÿ“Œ Overview

This project implements an OpenEnv-compatible environment that simulates real-world developer tasks. The environment allows an AI agent to perform tasks such as fixing syntax errors, cleaning code, and reviewing code.

It is designed for evaluating AI systems in practical software engineering workflows.


๐ŸŽฏ Motivation

Developers spend significant time debugging, formatting, and reviewing code. This environment replicates these real-world tasks so that AI agents can be evaluated on meaningful and useful work instead of toy problems.


๐Ÿง  OpenEnv Interface

The environment follows the OpenEnv specification:

  • โ€”reset() โ†’ Returns initial observation
  • โ€”step(action) โ†’ Returns (observation, reward, done, info)
  • โ€”state() โ†’ Returns current state

๐Ÿ” Observation Space

The agent receives a task as input in text form.

Example: Fix syntax error: print('Hello'


โšก Action Space

The agent must return a solution as text.

Example: print('Hello')


๐ŸŽฏ Reward Function

  • โ€”1.0 โ†’ Correct answer
  • โ€”0.0 โ†’ Incorrect answer
  • โ€”Can be extended to give partial rewards

The reward is deterministic and reproducible.


๐Ÿงช Tasks

๐ŸŸข Easy Task

Fix simple syntax errors Example: Missing parentheses


๐ŸŸก Medium Task

Clean and format messy code Example: Improve readability and indentation


๐Ÿ”ด Hard Task

Perform code review Example: Detect bugs and suggest improvements


๐Ÿ“Š Grading

Each task includes a programmatic grader:

  • โ€”Returns score from 0.0 to 1.0
  • โ€”Fully correct โ†’ 1.0
  • โ€”Incorrect โ†’ 0.0

๐Ÿ“ Project Structure

openenv-dev-assistant/ โ”‚ โ”œโ”€โ”€ env.py โ”œโ”€โ”€ models.py โ”œโ”€โ”€ tasks.py โ”œโ”€โ”€ grader.py โ”œโ”€โ”€ run_baseline.py โ”œโ”€โ”€ requirements.txt โ”œโ”€โ”€ openenv.yaml โ”œโ”€โ”€ Dockerfile โ””โ”€โ”€ README.md


โ˜๏ธ Deployment (Hugging Face Spaces)

  1. 1.Go to Hugging Face Spaces
  2. 2.Create new Space
  3. 3.Select Docker as SDK
  4. 4.Upload all project files
  5. 5.Add tag: openenv

โœ… Requirements Checklist

  • โ€”[x] Real-world task simulation
  • โ€”[x] OpenEnv interface implemented
  • โ€”[x] At least 3 tasks (easy, medium, hard)
  • โ€”[x] Programmatic grading
  • โ€”[x] Reward function
  • โ€”[x] Docker support
  • โ€”[x] Documentation

๐Ÿš€ Future Improvements

  • โ€”Integrate OpenAI API for real agent evaluation
  • โ€”Add more complex coding tasks
  • โ€”Improve reward function with partial scoring
  • โ€”Expand dataset of tasks

๐Ÿ“Œ Author

Team Neon