whatisgithub

What is mazebase?

facebookarchive/mazebase — explained in plain English

Analysis updated 2026-08-07 · repo last pushed 2019-10-21

246LuaAudience · researcherComplexity · 3/5DormantSetup · moderate

In one sentence

MazeBase is a sandbox tool for AI researchers to build simple 2D maze games and train neural networks to play them. Games are described to the AI using text sentences instead of pixels, making it useful for studying language understanding.

Mindmap

mindmap
  root((repo))
    What it does
      Builds 2D maze games
      Trains AI to play
      Text-based game state
    Tech stack
      Lua
      Torch framework
      Browser visualization
    Use cases
      Study reinforcement learning
      Test language understanding
      Train neural networks
    Game features
      Walls and water
      Switches and doors
      Pushable blocks
    Audience
      AI researchers
      ML engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build and test custom 2D maze games to study how AI learns through trial and error.

USE CASE 2

Evaluate whether an AI model can understand and follow natural language instructions in game environments.

USE CASE 3

Train neural networks on included games like block-pushing or switch-door navigation and visualize the results.

USE CASE 4

Design games with tunable difficulty to benchmark reinforcement learning model performance.

What is it built with?

LuaTorch

How does it compare?

facebookarchive/mazebaseechasnovski/nvimellisonleao/carbon-now.nvim
Stars246203195
LanguageLuaLuaLua
Last pushed2019-10-212026-06-162025-11-05
MaintenanceDormantMaintainedQuiet
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Built on Torch, a retired ML framework using Lua, which requires installing legacy dependencies that may be difficult to set up on modern systems.

So what is it?

MazeBase is a tool that lets researchers build simple 2D maze-like games and train AI models to play them. The core benefit is providing a flexible sandbox where you can quickly design games with specific challenges, tune their difficulty, and then teach neural networks to solve those tasks through trial and error. The games take place on a 2D grid. An agent (the player character) navigates this grid, which can contain various items like walls, water that slows movement, colored switches that open matching doors, and pushable blocks. The games are presented to the AI not as pixels on a screen, but as a list of text sentences describing what is where. For example, the model might see: "Block at [-1,4]. Switch at [+3,0] with blue color." The agent then takes actions, the game updates, and the model tries to figure out the best moves to reach its goals. This project would be used by AI researchers or engineers studying reinforcement learning. For example, if you want to test how well an AI model understands language instructions, you could use the "Conditional Goals" game where the agent must read a sentence telling it which goal to visit based on a switch's color. Ten games are already included, with tasks ranging from pushing blocks to navigating around walls through doors. The project also includes code to train neural networks to play these games, along with a visual display so you can watch the trained models play in your browser. Notably, it was built with Torch, a machine learning framework that is now largely retired, so the code is written in Lua rather than the Python most modern AI tools use.

Copy-paste prompts

Prompt 1
Set up MazeBase and train a neural network to play one of the included games like Conditional Goals, then render the gameplay in the browser.
Prompt 2
Create a custom MazeBase game on a 2D grid with walls, a colored switch, and a matching door where the agent must read a text instruction to know which door to open.
Prompt 3
Modify an existing MazeBase game to adjust its difficulty by adding water tiles that slow the agent down, then retrain the model and compare performance.
Prompt 4
Use MazeBase to build a benchmark task where the AI agent must push a block to a target location while navigating around walls, and evaluate a reinforcement learning model on it.

Frequently asked questions

What is mazebase?

MazeBase is a sandbox tool for AI researchers to build simple 2D maze games and train neural networks to play them. Games are described to the AI using text sentences instead of pixels, making it useful for studying language understanding.

What language is mazebase written in?

Mainly Lua. The stack also includes Lua, Torch.

Is mazebase actively maintained?

Dormant — no commits in 2+ years (last push 2019-10-21).

How hard is mazebase to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mazebase for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.