battlesnake-go

A simple BattleSnake AI written in Go.

Visit battlesnake.io/readme for API documentation and instructions for running your AI.

To get started, you'll need:

1. A working Go development environment (guide).
2. Experience deploying Go apps to Heroku
3. Your Snake ID from http://www.battlesnake.io/team

Running the AI locally

1. Fork this repo.

2. Clone repo to your development environment:

git clone [email protected]:USERNAME/battlesnake-go.git $GOPATH/github.com/USERNAME/battlesnake-go
cd $GOPATH/github.com/USERNAME/battlesnake-go

3. Compile the battlesnake-go server.

go build

This will create a battlesnake-go executable.

4. Set your snake ID as an environment variable.

export SNAKE_ID=ABCDEF1234

This will allow your snake to locate itself during the game.

5. Run the server.

./battlesnake-go

6. Test the client in your browser: http://127.0.0.1:9000

Deploying to Heroku

1. Create a new Go Heroku app using Go buildpack.

heroku create [APP_NAME] --buildpack https://github.com/kr/heroku-buildpack-go

2. Push code to Heroku servers.

git push heroku master

3. Set the SNAKE_ID environment variable in your Heroku app.

heroku config:set SNAKE_ID=ABCDEF1234

4. Open Heroku app in browser.

heroku open

Or go directly via http://APP_NAME.herokuapp.com

5. View/stream server logs.

heroku logs --tail

Questions?

Email, Twitter