Skip to content
Game Agent Framework. Helping you create AIs / Bots to play any game you own!
Branch: dev
Clone or download
Latest commit b8eec10 Nov 27, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config more explicit crossbar integration Aug 2, 2018
dashboard New async input controller (default) Jul 29, 2018
notebooks 2018.1.0 Feb 2, 2018
serpent Hack to fallback on pattern matching for window names on Windows Aug 18, 2018
tests/unit multiple actions per reinforcement learning agent input; continuous c… Mar 10, 2018
.gitignore
CHANGELOG.md 2018.1.2 Feb 17, 2018
CONTRIBUTING.md
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md Apr 9, 2018
LICENSE.md
README.md
setup.cfg refactor for python packaging Sep 17, 2017
setup.py added loggers to send Agent metrics to 3rd-party solutions Jul 29, 2018

README.md

Serpent.AI - Game Agent Framework (Python)



Warning: End of life (November 2018)

The development work on the framework has stopped. The necessary time to keep up with the crazy nature of reinforcement learning, the bug fixing and community support cannot be justified anymore (sadly). The repository will remain up as it should be, for people interested in the field, a very exhaustive resource code-wise to interact with games for machine learning. There is a ton to learn by snooping through the code. Have Fun!

Serpent.AI is a simple yet powerful, novel framework to assist developers in the creation of game agents. Turn ANY video game you own into a sandbox environment ripe for experimentation, all with familiar Python code. The framework's raison d'être is first and foremost to provide a valuable tool for Machine Learning & AI research. It also turns out to be ridiculously fun to use as a hobbyist (and dangerously addictive; a fair warning)!

The framework features a large assortment of supporting modules that provide solutions to commonly encountered scenarios when using video games as environments as well as CLI tools to accelerate development. It provides some useful conventions but is absolutely NOT opiniated about what you put in your agents: Want to use the latest, cutting-edge deep reinforcement learning algorithm? ALLOWED. Want to use computer vision techniques, image processing and trigonometry? ALLOWED. Want to randomly press the Left or Right buttons? sigh ALLOWED. To top it all off, Serpent.AI was designed to be entirely plugin-based (for both game support and game agents) so your experiments are actually portable and distributable to your peers and random strangers on the Internet.

You'll also be glad to hear that all 3 major OSes are supported: Linux, Windows & macOS.

Experiment: Game agent learning to defeat Monstro (The Binding of Isaac: Afterbirth+)

Background

The project was born out of admiration for / frustration with OpenAI Universe. The idea is perfect, let's be honest, but some implementation details leave a lot to be desired. From these, the core tennets of the framework were established:

  1. Thou shall run natively. Thou shalt not use Docker containers or VNC servers.
  2. Thou shall allow a user to bring their own games. Thou shalt not wait for licensing deals and special game APIs.
  3. Thou shall encourage diverse and creative approaches. Thou shalt not only enable AI flavors of the month.

Want to know more about how Serpent.AI came to be? Read The Story Behind Serpent.AI on the blog!

Documentation

Guides, tutorials and videos are being produced and added to the GitHub Wiki. It currently is the official source of documentation.

Experiment: Game agent learning to match tiles (You Must Build a Boat)

Business Contact: info@serpent.ai

You can’t perform that action at this time.