gameboy superoptimizer
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Forest Belton 97b70e2ef0 Minor improvements 1 year ago
docs Add reference paper and update README 1 year ago
gbso Minor improvements 1 year ago
tests Implement operand mutation 1 year ago
.gitignore Initial commit 1 year ago Add TODO list to README 1 year ago Write CPU tests for 8-bit loads 1 year ago Add example testcase that includes carry set 1 year ago
poetry.lock Initial commit 1 year ago
pyproject.toml Initial commit 1 year ago


An implementation of the stochastic superoptimization algorithm STOKE for the Sharp LR35902 (also known as GB-Z80).


Make sure you have Poetry and Python 3.9+ installed. Then run:

$ poetry install


Input programs are specified as a list of CPU instructions. For a list of instructions available to the processor, take a look at or a standard reference.

Once you have the program specified, call gbso.optimize.optimize on the program. A superoptimized, behaviorally equivalent program will be returned. Additional parameters are available to the optimization function to control search.

For a comprehensive example, see