Skip to content

Latest commit

 

History

History
106 lines (74 loc) · 2.52 KB

README.md

File metadata and controls

106 lines (74 loc) · 2.52 KB
Raw

endless-fake

Build Status

Heavy work in progress!

Helpers for building and evaluating artificial intelligence agents playing the Endless Lake video game.

endless-fake heading

Pre-requisites

  • Google Chrome with the chromedriver binary
  • Python 3.6 (not tested under prior versions yet)

Installation

$ python setup.py install

Copy the chromedriver binary in your current working directory. It should be fine if your system can already find it through the PATH environment variable.

Usage

$ endless-fake -h
Endless Fake

Usage:
  endless-fake <command> [<args>...]
  endless-fake (-h | --help)
  endless-fake (-v | --version)

Options:
  -h --help     Show this screen.
  -v --version  Show version.

Commands:
  evaluate      Evaluate a previously trained machine learning model.
  fetch         Download a copy of the Endless Lake video game.
  genetics      Run a genetics algorithm to let the computer learn by itself.
  patch         Patch a copy of the video game.
  playback      Play a previously recorded gameplay video.
  record        Start a web browser and record a gameplay video.
  restore       Revert the initial backup of the video game.
  teach         Write a CSV file containing inputs and expected outputs.
  train         Train a machine learning model from a CSV file.

Getting Started

First, let's download a copy of the Endless Lake video game.

$ endless-fake fetch ./game

Patch the game files to make an offline version.

$ endless-fake patch ./game

Start recording a gameplay video, in order to become independent of the web browser. Be careful as the video might become heavy since it will keep uncompressed frames!

$ endless-fake record --output video.avi ./game

Run the included scanner, to make sure the video has been well written and our scanner is working fine.

$ endless-fake playback video.avi

Get some data by recording your actions corresponding to the inputs.

$ endless-fake teach --output data.csv ./game

Train the included neural network agent with the previously collected data.

$ endless-fake train --output brain.dat data.csv

Evaluate the neural network we've just generated.

$ endless-fake evaluate --input brain.dat ./game

You can also just let your computer learn how to play by itself.

$ endless-fake genetics ./game