This pokerbot plays automatically on Pokerstars, Partypoker and GG Poker. Any other table can be mapped as well. It works with image recognition, montecarlo simulation and a basic genetic algorithm. The mouse is moved automatically and the bot can potentially play for hours based on a large number of parameters.
You can download the binaries and run the executable directly from here: https://sourceforge.net/projects/partypoker-pokerstars-pokerbot/
- Use Fast Forward Tables
- Select Official PartyPoker table scraper
- Use Zoom Tables
- Select Official Poker Stars table scraper
- For Pokerstars you will need to make some adjustments to the client. It needs to look exactly as the below, in order to run it with the Official Pokerstars Table scraper:
- Make sure to match the card styles (4 color), covered card styles, and table styles.
Make sure your GGPoker setup looks as follows when using it with the Official GGPoker Table:
If you just want to run the bot, please do the following:
Install the binearies of the bot from here: https://sourceforge.net/projects/partypoker-pokerstars-pokerbot/
You can then immediately run the bot. It will analyze the poker client, move the mouse and play in accordance with one of its pre-programmed strategies. Most of the strategies are based on zoom or Fast Forward tables. You are welcome to edit and imporve any strategies to optmize the play of the bot for your needs.
In most cases it may be useful to put the poker client inside a virtual machine to avoid it from interfering with the bot. Also, the bot will then be able to control the mouse inside the virtual machine, without blocking the whole computer:
- Download Virtualbox: https://www.virtualbox.org/
- Download Windows 10 Iso File for example from here https://www.softlay.com/apps/operating-system
- Create a new virtual box environment and use the ISO file as a startup
- Make sure to give the Virtualbox only 1 CPU as the computing power is needed for the bot (mainly for OCR)
- Install Partypoker or Pokerstars in the virtual box environment
- Install the pokerbot directly onto your computer (outside of the virtual box)
- In the Setup select your virtual box instance (instead of direct mouse control)
- Join the telegram chat by pressing the chat button
- The current version Only works on windows
- Do not obstruct the view of the table as the bot is based on image recognition
- Only one table window should be visible.
- For best performance minimize all windows in the vm, except the table window itself
- Don't use any dpi scaling in the virtualbox
- In setup, try to select your virtual machine instead of direct mouse control. That way mouse movements won't obstruct you.
- You can see the profitability of each strategy in the strategy analyzer.
- The bar chart indicates what action types have led to wins or losses at each stage (preflop, flop turn and river)
Looking at the stacked bar chart in more detail, gives you clues how to adjust the strategy to maximize your wins:
Analyze individual rounds within each stage:
Analyze individual hands:
A variety of factors are taken into consideration when the bot makes decisions and they can be adjusted in the strategy editor:
- Equity (winning probability), which is calculated by a montecarlo simulation
- Equity and minimum call/bet value need to be on the left of the corresponding curve in order for the bot not to fold
- Various other factors, such as behaviour in the previous rounds are taken into consideration. Check out the strategy editor for more details.
- Hover over each item to see a more detailed description
A variety of other options can be edited for each strategy:
- You will generally require at least 2000 hands played with a strategy to draw any conclusions. Even better 5000 hands. Anything less than 1000 hands is completely random.
- Best buy in more than the minimum, this will improve the bots performance as it has more leeway to play. For example on a 0.01/0.02 table, buy in more than the minimum of $2. Ideally start with $4 or even more.
- Look at the strategy analyzer and work your way backwards. First improve the River play, then once this is good move on to the Turn, then to the Flop etc. This is because the game is path dependent.
- If you make changes in the ranges, you may need to adapt all minimum equities as it changes the equity calculation.
- Good Luck!
The full version allows you to:
- Edit and create new Strategies
- View all Strategies of all users
To purchase, please follow this link. You'll then receive a password within 24 hours. https://www.paypal.com/webapps/billing/plans/subscribe?plan_id=P-910576034F790373KMC6UZOQ
You can also get a free subscription if you make some meaningful contribution to the codebase.
The easiest way to contribute is by:
- Adding new tables
- Adding new strategies
- Directly add fixes to the code and create a pull request
The bot can learn to read new tables, either by using templates or by training a neural network that uses data augmentation based on the given templates.
Click here to see a Video description how to add a new table
The setup to add new tables looks like this:
- Open the pokerbot and click on table setup to open the window that helps you create new tables.
- Open the poker client next to it, make sure it's not dpi scaled, so the pokerbot can take screenshots.
- Start with creating a new template, you can do this by entering a name for your template, for example Pokerstars 1-2 zoom poker. Click on 'Blank new'.
- Now the first think you want to do is to take a screenshot of the pokerstars window with the table. You can do this by pressing on the Take screenshot button. You should not see in the lower window a full screenshot of what is on your screen.
- The first step is now to mark the top left corner of the poker tables window, which will be the point of reference for everything else that will follow. To mark the top left corner, you need to mark it by first clicking on the top left part of it and then on the right lower part of it. once you have done this, it will appear in the second window. You can save it by clicking on the "save newly selected top left corner" button.
- Now you can crop it by pressing on the crop from top left corner button. This will discard most of the screenshot and only keep the screenshot from the top left corner and everything a few hundred pixels to the right of it and below.
- Next you will want to mark everything else in the window. Start with the Buttons search area. You can do this again by clicking on the top left area of the buttons and then on the bottom right area of where the buttons appear. Once you are happy with the selection, click on the "Buttons search area".
- If you hover over the buttons, you will get a more detailed description of what you need to pay attention to.
- Note that you will need to take many screenshots, crop them (don't select the top left corner again, as this you should only do once), instead load it and then crop the image. After that make your selection of the different images and save them by pressing on the corresponding button. You'll need to teach it every card and every button etc.
- Download pycharm communite edition as an IDE from here: https://www.jetbrains.com/pycharm/download/#section=windows
- Install python 3.7 or Anaconda (=python with packages) from here: https://www.python.org/downloads/release/python-379/
- Create an environment with
conda create -n poker python=3.7
or use pycharm's functionality to create a new virtual environment. Check youtube for details. - Install all the packages with
pip install -r requirements.txt
- Install tesserocr: pip install https://github.com/simonflueckiger/tesserocr-windows_build/releases/download/tesserocr-v2.4.0-tesseract-4.0.0/tesserocr-2.4.0-cp37-cp37m-win_amd64.whl
- You also may need to get c++ runtime distributable: https://visualstudio.microsoft.com/downloads/
- Install virtualbox from https://www.virtualbox.org/wiki/Downloads and put the poker client into the virtual box. That way it can be controlled without having to use the mouse in your main window.
- Run
main.py
from pycharm after setting up the above created virtual environment as interpreter (check youtube)
main.py: entry point
Contains user interface and routines that help map new tables
recognize_table
: Functions to recognize the different items on the table, based on the created mappingscreen_operations
: Various routines, such as taking screen shots, cropping etctable_setup
: Routines in relation to the guiui_table_setup
: QT user interface. Corresponding py file is created with makegui.bat in the parent folder. To edit the gui download QT Designer and open the .ui file.
decisionmaker.py
: The ultimate decision what action should be taken based on the inputmontecarlo_numpy2.py
: fast numpy based montecarlo simulation to calculate equity. Not yet working correctly. Some tests are failing. Feel free to fix them.montecarlo_python.py
: relatively slow python based montecarlo for equity calculation. Supports preflop ranges for other players.
test_montecarlo_numpy.py
: tests for the numpy montecarlotest_pylint.py
: pylint and pydoc tests to ensure pep8 standards and static code analysis
- Download QT for open source project: https://www.qt.io/download-open-source
- Use the qt designer to edit any of the .ui files in gui/ui
- [ ] Update tests. Some are currently outdated. More tests are needed
- [ ] Add more strategies
- [ ] Switch from using pytesseract to tesserocr to speed up OCR, this should considerably speed up the bot
- [ ] Better Analyze the collected data to improve strategies
- Fixing code and making a pull request back into the origin/master:
It will be hard for one person alone to beat the world at poker. That's why this repo aims to have a collaborative environment, where models can be added and evaluated.
To contribute do the following:
- Get Pycharm and build the virtual python environment. Use can do:
pip install -r requirements.txt
(see above) - Clone your fork to your local machine. You can do this directly from pycharm: VCS --> check out from version control --> git
- Add as remote the original repository where you created the fork from and call it upstream (the connection to your fork should be called origin). This can be done with vcs --> git --> remotes
- Create a new branch: click on master at the bottom right, and then click on 'new branch'
- Make your edits.
- Ensure all tests pass. Under file --> settings --> python integrated tools switch to pytest. You can then just right click on the tests folder and run all tests. All tests need to pass. Make sure to add your own tests by simply naming the funtion test_...
- Make sure all the tests are passing. Best run pytest as described above (in pycharm just right click on the tests folder and run it). If a test fails, you can debug the test, by right clicking on it and put breakpoints, or even open a console at the breakpoint: https://stackoverflow.com/questions/19329601/interactive-shell-debugging-with-pycharm
- Commit your changes (CTRL+K}
- Push your changes to your origin (your fork) (CTRL+SHIFT+K)
- To bring your branch up to date with upstream master, if it has moved on: rebase onto upstream master: click on your branch name at the bottom right of pycharm, then click on upstream/master, then rebase onto. You may need to resolve soe conflicts. Once this is done, make sure to always force-push (ctrl+shift+k), (not just push). This can be done by selecting the dropdown next to push and choose force-push (important: don't push and merge a rebased branch with your remote)
- Create a pull request on your github.com to merge your branch with the upstream master.
- When your pull request is approved, it will be merged into the upstream/master.
- Please make sure that all tests are passing, including the pylint test. You can either run them locally on your machine, or when you push check the travis log on github. [currently many are failing, feel free to help fixing them!]
- It only works on windows currently
- It only works with fast forward games with real money on PartyPoker. Use the Supersonic3 table for Partypoker or McNaught table in Pokerstars
- The poker table window has to be fully visible and cannot be scaled, otherwise it won't be detected properly
- In Partypoker, when you open the table, choose table options and then choose back to default size to make sure the table is in default size.
- Go to setup and choose direct mouse control.
- For Pokerstars you definitely do, otherwise you will be blocked and your account will be frozen within minutes. For Partypoker I'm not sure. But best check the terms and conditions.
- Make sure everything looks exactly like in the picture above. The buttons need to look exactly like this and it needs to be in English and not scaled. Colours need to be standard.
- If things still don't work, consider teaching it a new table
- Check the log file. In the folder where you installed the pokerbot, there is a subfolder with the log files in /log. There are also screenshots in /log/screenshots that may be able to help debug the problem.
- Create a issue on the link at the top of this github page https://github.com/dickreuter/Poker/issues or email [email protected]
Training the bot by playing against itself is a separate project which can be found here: https://github.com/dickreuter/neuron_poker