The Pokemon Go Bot, baking with community.
Python JavaScript Batchfile Other
Latest commit 26117e6 Feb 17, 2017 @solderzzc solderzzc committed on GitHub Merge pull request #5915 from PokemonGoF/dev
Dev merge to Master
Failed to load latest commit information.
.github Support details update (#3965) Aug 15, 2016
configs Poke hunter lockon (#5902) Feb 7, 2017
data Another fix (#5869) Jan 13, 2017
docs Fix step walker and move to fort issues (#5892) Jan 30, 2017
map-chat Switch websocket to Sep 10, 2016
pokemongo_bot BUGFIX: Poke hunter lockon (#5904) Feb 9, 2017
tests Proto requirements fix (#5888) Jan 27, 2017
web @ 0852dc4 Upgrade submodule (#5861) Jan 11, 2017
windows_bat add hashing key to and PokemonGo-Bot-Configurator.bat and fo… Jan 13, 2017
.dockerignore Ignore files in git and docker Aug 25, 2016
.gitattributes gitattributes .pickle binary Sep 7, 2016
.gitignore added pgoapi files to .gitignore Oct 5, 2016
.gitmodules Update merge (#1) Aug 30, 2016
.mention-bot Dev merge to master, PR (#3564) Aug 11, 2016
.pullapprove.yml One to improve pull approval.yml. Aug 28, 2016
.pylintrc Updating the .pylintrc file to ignore errors that are fine for now (#625 Jul 24, 2016
.styles.yapf Make the code look nicer Jul 23, 2016
.travis.yml cache pip wheels also! Sep 9, 2016
Dockerfile Change entrypoint to CMD on Dockerfile to enable debug Sep 14, 2016
LICENSE Dev merge to master (#2939) Aug 7, 2016
Procfile Dev merge to master, PR (#3891) Aug 14, 2016 Update Jan 14, 2017
docker-compose.yml Add ws_server to docker-compose Sep 14, 2016
docker-compose_tor.yml Use TZ as timezone environment (#5091) Sep 2, 2016 Dev merge to master, PR (#4178) Aug 17, 2016 Merge branch 'master' into dev Jan 10, 2017 Revert "Trying to set up appveyor for windows based CI" (#4317) Aug 20, 2016
requirements.txt Added dependency for urllib 1.18, telegram bot doesn't work with urll… Jan 31, 2017 Fixed an error Sep 13, 2016 Added Fedora > 17 support. Feb 15, 2017 Added for web server fast run (#5296) Sep 8, 2016 Change localhost to on ws_server to run server corectly Sep 14, 2016


PokemonGo-Bot is a project created by the PokemonGoF team. Since no public API available for now, a patch to use HASH-Server was applied. PokemonGoF is not part of HASH-Server dev team and has no connection with it.


Bitcoin: 1PJMCx9NNQRasQYaa4MMff9yyNFffhHgLu

Table of Contents

The project is currently setup in two main branches:

  • dev also known as beta - This is where the latest features are, but you may also experience some issues with stability/crashes.
  • master also known as stable - The bot 'should' be stable on this branch, and is generally well tested.

Slack Channel

Configuration issues/help

If you need any help please don't create an issue as we have a great community on Slack. You can count on the community in #help channel.

Development Channel

  • #dev channel in slack


Bugs / Issues

If you discover a bug in the bot, please search our issue tracker first. If it hasn't been reported, please create a new issue and ensure you follow the template guide so that our team can assist you as quickly as possible.

Feature Requests

If you have a great idea to improve the bot, please search our feature tracker first to ensure someone else hasn't already come up with the same great idea. If it hasn't been requested, please create a new request and ensure you follow the template guide so that it doesnt get lost with the bug reports. While you're there vote on other feature requests to let the devs know what is most important to you.

Pull Requests

If you'd like to make your own changes, make sure you follow the pull request template, and ensure your PR is made against the 'dev' branch.

If this is your first time making a PR or aren't sure of the standard practice of making a PR, here are some articles to get you started.


  • GPS Location configuration
  • Search Pokestops
  • Catch Pokemon
  • Determine which pokeball to use (uses Razz Berry if the catch percentage is low!)
  • Exchange Pokemon as per configuration
  • Evolve Pokemon as per configuration
  • Auto switch mode (Inventory Checks - switches between catch/farming items)
  • Limit the step to farm specific area for pokestops
  • Rudimentary IV Functionality filter
  • Ignore certain pokemon filter
  • Adjust delay between Pokemon capture & Transfer as per configuration
  • Hatch eggs
  • Incubate eggs
  • Crowd Sourced Map Prototype
  • Standalone Desktop Application
  • Use candy


PokemonGo-Bot is very popular and has a vibrant community. Because of that, it has become very difficult for us to know how the bot is used and what errors people hit. By capturing small amounts of data, we can prioritize our work better such as fixing errors that happen to a large percentage of our user base, not just a vocal minority.

Our goal is to help inform our decisions by capturing data that helps us get aggregate usage and error reports, not personal information. To view the code that handles analytics in our master branch, you can use this search link.

If there are any concerns with this policy or you believe we are tracking something we shouldn't, please open a ticket in the tracker. The contributors always intend to do the right thing for our users, and we want to make sure we are held to that path.

If you do not want any data to be gathered, you can turn off this feature by setting health_record to false in your config.json.



  • eggins [first pull request]
  • crack00r
  • ethervoid
  • Bashin
  • tstumm
  • AdaptCharm
  • Reaver01
  • rarshonsky
  • earthchie
  • haykuro
  • 05-032
  • sinistance
  • CapCap
  • YvesHenri
  • mzupan
  • gnekic(GeXx)
  • Shoh
  • JSchwerberg
  • luizperes
  • brantje
  • VirtualSatai
  • dmateusp
  • jtdroste
  • msoedov
  • Grace
  • Calcyfer
  • asaf400
  • guyz
  • DavidK1m
  • budi-khoirudin
  • riberod07
  • th3w4y
  • Leaklessgfy
  • steffwiz
  • pulgalipe
  • BartKoppelmans
  • phil9l
  • VictorChen
  • AlvaroGzP
  • fierysolid
  • surfaace
  • surceis
  • SpaceWhale
  • klingan
  • reddivision
  • DayBr3ak
  • kbinani
  • mhdasding
  • MFizz
  • NamPNQ
  • matheussampaio
  • Abraxas000
  • lucasfevi
  • pokepal
  • Moonlight-Angel
  • mjmadsen
  • nikofil
  • bigkraig
  • nikhil-pandey
  • thebigjc
  • JaapMoolenaar
  • eevee-github
  • g0vanish
  • cmezh
  • Nivong
  • kestel
  • simonsmh
  • joaodragao
  • extink
  • Quantra
  • pmquan
  • net8q
  • SyncX
  • umbreon222
  • DeXtroTip
  • rawgni
  • Breeze Ro
  • bruno-kenji
  • Gobberwart
  • javajohnHub
  • kolinkorr839


©2016 Niantic, Inc. ©2016 Pokémon. ©1995–2016 Nintendo / Creatures Inc. / GAME FREAK inc. © 2016 Pokémon/Nintendo Pokémon and Pokémon character names are trademarks of Nintendo. The Google Maps Pin is a trademark of Google Inc. and the trade dress in the product design is a trademark of Google Inc. under license to The Pokémon Company. Other trademarks are the property of their respective owners. Privacy Policy

PokemonGo-Bot is intended for academic purposes and should not be used to play the game PokemonGo as it violates the TOS and is unfair to the community. Use the bot at your own risk.

PokemonGoF does not support the use of 3rd party apps or apps that violate the TOS.