Add maze environment and example #106

VivekSil · 2025-10-27T18:40:27Z

This PR will add Maze environment (#105)

Specifications:

The maze can be specified by the user with start and exit points as a numpy array.
Current default maze is of size 8x8 with start and exit cells being (0,0) and (7,7) respectively.

Reward setting:

reward_exit: Reward for reaching the exit cell
reward_move: Reward for a move that didn't find the exit but is valid
penalty_visited: penalty for revisiting a cell
penalty_impossible: penalty for invalid move (wall/outside)

meta-cla · 2025-10-27T18:40:33Z

Hi @VivekSil!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at [email protected]. Thanks!

meta-cla · 2025-10-27T18:42:32Z

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

Copilot

Pull Request Overview

This PR integrates a Maze game environment with the OpenEnv framework, providing both server-side and client-side implementations with Docker support.

Implements MazeEnvironment wrapper that exposes the Maze game through OpenEnv's Environment interface
Adds HTTP client and server infrastructure for remote maze environment interaction
Includes example scripts demonstrating both automated and human-interactive maze solving

Reviewed Changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 15 comments.

Show a summary per file

File	Description
src/envs/maze_env/server/mazearray.py	Defines the maze layout as a numpy array
src/envs/maze_env/server/maze_environment.py	Wraps Maze game to implement OpenEnv Environment interface
src/envs/maze_env/server/maze.py	Core Maze implementation with coordinate system (col, row)
src/envs/maze_env/server/app.py	FastAPI application exposing maze environment over HTTP
src/envs/maze_env/server/init.py	Package exports for server components
src/envs/maze_env/server/Dockerfile	Container configuration for maze environment server
src/envs/maze_env/models.py	Data models for actions, observations, and state
src/envs/maze_env/client.py	HTTP client for connecting to maze environment server
src/envs/maze_env/init.py	Package exports for client components
src/envs/maze_env/README.md	Documentation for maze environment usage
examples/maze_simple.py	Example demonstrating automated maze navigation
examples/maze_human.py	Example demonstrating human-interactive maze solving
.github/workflows/docker-build.yml	Adds maze-env to CI/CD Docker build workflow

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

src/envs/maze_env/server/maze_environment.py

src/envs/maze_env/server/app.py

src/envs/maze_env/server/__init__.py

examples/maze_human.py

src/envs/maze_env/server/maze_environment.py

src/envs/maze_env/models.py

github-actions · 2025-11-02T12:41:30Z