Metadata-Version: 2.4
Name: mazebench
Version: 0.2.17
Summary: Build and play persistent 3D worlds, then benchmark coding agents and Prime Intellect Verifiers against them.
Project-URL: Homepage, https://mazebench.com
Project-URL: Source, https://github.com/mazebench/MazeBenchEngine
License-Expression: MIT
License-File: LICENSE
Keywords: agents,benchmark,maze,reinforcement-learning,world-building
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.9
Provides-Extra: prime
Requires-Dist: verifiers>=0.1.14; (python_version >= '3.10' and python_version < '3.14') and extra == 'prime'
Description-Content-Type: text/markdown

# MazeBench

MazeBench is a local browser app for building and playing persistent 3D puzzle
worlds, then evaluating coding agents in the same JavaScript engine.

## Install

Python 3.9+ and Node.js are required.

```bash
pip install mazebench
mazebench launch
```

This opens the Play, Build, and Agent modes. Run `mazebench --help` for other
commands.

Play directly in an ASCII terminal with arrow-key controls:

```bash
mazebench ascii
mazebench ascii --level CxD
```

Both `CxD` and the full `level_CxD` level ID are accepted.

Play interactively with the same controls while showing the structured JSON
observation a model receives, with literal object names and every room object
included:

```bash
mazebench json --level CxD --omniscient
```

Omit `--omniscient` to include only objects visible in the equivalent ASCII
view. Names are not hidden unless `--hide-names` is passed explicitly. JSON
arrays are kept on one line in the terminal. Pipe the output or pass `--once`
to print a single snapshot instead of starting an interactive session.

Local agent runs also require Docker and either the Codex CLI or Claude Code.
Replay video requires a Chromium-family browser and `ffmpeg`.

[Website](https://mazebench.com) ·
[Source](https://github.com/mazebench/MazeBenchEngine)
