https://github.com/awslabs/sagemaker-battlesnake-ai

Starter pack to build an AI for Battlesnake with Amazon Sagemaker more content on wiki:
https://github.com/awslabs/sagemaker-battlesnake-ai

Last synced: 30 days ago
JSON representation

Starter pack to build an AI for Battlesnake with Amazon Sagemaker more content on wiki:

• Host: GitHub
• URL: https://github.com/awslabs/sagemaker-battlesnake-ai
• Owner: awslabs
• License: apache-2.0
• Created: 2020-02-24T00:59:13.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2022-12-21T00:12:33.000Z (over 2 years ago)
• Last Synced: 2025-03-13T02:37:55.291Z (about 1 month ago)
• Language: Python
• Homepage: https://github.com/awslabs/sagemaker-battlesnake-ai/wiki
• Size: 113 MB
• Stars: 90
• Watchers: 10
• Forks: 53
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-aws-workshops - SageMaker for Battlesnake AI

README

        
__BLOG POST DOCUMENTATION__ : _Consider reading our detailed blog posts about this project:_

* _[Introduction with MXNet](https://aws.amazon.com/blogs/machine-learning/building-an-ai-powered-battlesnake-with-reinforcement-learning-on-amazon-sagemaker/)_

* _[Improvement with RLlib](https://aws.amazon.com/blogs/machine-learning/scaling-your-ai-powered-battlesnake-with-distributed-reinforcement-learning-in-amazon-sagemaker/)_

# Amazon SageMaker for Battlesnake AI

This project shows how to build and deploy an AI for the platform [Battlesnake](https://play.battlesnake.com/) on AWS with [Amazon Sagemaker](https://aws.amazon.com/sagemaker/)!

It is ready to deploy and contains learning materials for AI enthusiasts.

__What is Battlesnake?__ (taken from [battlesnake.com](https://docs.battlesnake.com/references/rules)):

> Battlesnake is an autonomous survival game where your snake competes with others to find and eat food without being eliminated. To accomplish this, you will have to teach your snake to navigate the serpentine paths created by walls, other snakes, and their own growing tail without running out of energy.

## Intention

This project contains a ready-to-use AI for Battlesnake as well as a development environment that can be used to modify and improve the AI.

The included AI makes movement decisions in two steps:

  1. __Run a Neural Network Model__ 

  2. __Run Heuristics__ (ie: additional code that can override the neural network's predicted best action so that your snake avoids colliding with walls, eats food if it is safe to do so, attempts to eat a competitor snake, ...)

Several pre-trained neural network models are provided within this project as well as some default heuristics. These pre-trained models (snakes) are not designed to win the Battlesnake competition, so you'll have to improve them in order to have a chance of winning. The training environment is provided for you to make modifications and to retrain the neural network models in order to obtain better results.

## Project Organisation

This project can be used in three steps:

- __[Step 1 - Deploy a Snake](Documentation/DeployTheAIEndpoint.md)__ : Deploy a snake with pre-trained AI. After this step, you'll be able to participate in a Battlesnake game! **Don't skip this step!** (This step also deploys a local environment which is needed for the following steps.)

- __[Step 2 - Build some Heuristics](Documentation/UpdateHeuristicsAndDeploy.md)__ : Write some rules for your snake to navigate common scenarios, visualize your snake, and publish the upgraded version of your snake!

- __[Step 3 - Upgrade your Reinforcement Learning Model](Documentation/TrainModelAndDeploy.md)__ : This is the most rewarding step. Retrain your snake with different settings, visualize your snake, and publish an upgraded version!

## Reinforcement learning packages

### Architecture

If you use Steps 1-3, you will have the following deployed within your AWS account:

![General Architecture](Documentation/images/ArchitectureSagemakerBattlesnakeFull.png "General Architecture")

### Cost

This project has been designed to run within the AWS free tiers for some time.

Refer to each step above in order to understand the costs that may be incurred after the free tiers are exceeded.

### Content

The included Jupyter notebooks are bundled with a step-by-step Battlesnake visualizer:

![Battlesnake visualizer](Documentation/images/battlesnake-debugger.png "Battlesnake visualizer")

With the Battlesnake visualizer, you can load any initial state and test how your snake will behave in various situations (See the [Visualize your algorithm](Documentation/UpdateHeuristicsAndDeploy.md#visualizing-your-algorithm) section for the full list of features.)

The source code of the project is organized as follows:

```

deployment                              # contains the templates and scripts to automate deployment

	> 

source                     

	> MXNetEnv                          # training environment with the MXNet implementation (deprecated - for reference only)

	> BattlesnakeGym					# openAI gym to simulate the battlesnake environment

	> RLlibEnv      					# contains the Jupyter notebook for model training and heuristics development

    > training           			    # contains source code for training

    > inference             			# contains source code for inference

```

## License

This project is licensed under the Apache-2.0 License.