Skip to content
A simple Battlesnake AI written in Python
Branch: master
Clone or download
brandonb927 Merge pull request #40 from battlesnakeio/fix-root-path-docs-link
Adds a link to the docs in the root URL path
Latest commit 1267fa0 Dec 21, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Update app/ Dec 21, 2018
static testing Feb 21, 2015
.gitignore added ping. removed code that caused stack traces on start Nov 18, 2018 Create May 12, 2018
LICENSE Update LICENSE Nov 17, 2018
Procfile Update Procfile Feb 19, 2016 added ping. removed code that caused stack traces on start Nov 18, 2018
runtime.txt Update the version of heroku to 2.7.15 Sep 4, 2018


A simple Battlesnake AI written in Python.

Visit for API documentation and instructions for running your AI.

This AI client uses the bottle web framework to serve requests and the gunicorn web server for running bottle on Heroku. Dependencies are listed in requirements.txt.


You will need...

Running the Snake Locally

  1. Fork this repo.

  2. Clone repo to your development environment:

git clone<your github username>/starter-snake-python.git
  1. Install dependencies using pip:
pip install -r requirements.txt
  1. Run local server:
python app/
  1. Test your snake by sending a curl to the running snake
curl -XPOST -H 'Content-Type: application/json' -d '{ "hello": "world"}' http://localhost:8080/start

Deploying to Heroku

  1. Create a new Heroku app:
heroku create [APP_NAME]
  1. Deploy code to Heroku servers:
git push heroku master
  1. Open Heroku app in browser:
heroku open

or visit

  1. View server logs with the heroku logs command:
heroku logs --tail


Email, or tweet @send_with_us.

You can’t perform that action at this time.