DeeperMind pokerbot for pokerstars, partypoker and GGPoker
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: http://deepermind-pokerbot
Running the bot:
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:
General setup:
If you just want to run the bot, please
do the following:
Install the binearies of the bot 👌 from here:
http://deepermind-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: //virtualbox/
Download Windows 10 Iso File for example from here
//softlay/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 discord chat 👌 by pressing the chat button or joining this link:
//discord.gg/xB9sR3Q7r3
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.
Strategy Analyzer
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:
Strategy editor
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:
Advice how to
improve strategies:
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 ofR$2. Ideally start withR$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!
Full version:
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. http://deepermind-pokerbot/purchase
Alternatively you can contact me via email
or discord and request a password directly and pay bitcoin 👌 to:
1Py5o4WLYMizXc8pFPqzD4yeCAm53BhJit
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
Mapping new tables
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 this link to see a Video description how to add a new table or
watch 👌 the video on deepermind-pokerbot
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
and save them by pressing on the corresponding button. You'll need
to teach it 👌 every card and every button etc.
Notes to keep in mind:
IT IS NOT
RECOMMENDED TO CONDUCT TESTS WITH REAL ACCOUNTS UNTIL 👌 YOU VERIFY THE CORRECT
FUNCTIONING OF THE BOT (ALSO TO AVOID LOSS OF ACCOUNTS AND CAPITAL)
Minimum system
requirements to run 👌 the bot:
Windows 10 x64 or later (It may work in previous versions
but its correct operation has not been verified)
RAM 👌 memory 4 GB or more
hard drive
space 1.6 GB (as always the more the better)
Micro processor with 4 cores and 👌 4 threads
or higher
GPU is not necessary (neural training gives the option to do it on
GPU)
screen resolution 1920*1800 (it 👌 can work with less but its correct operation has
not been verified)
consider the consumption of Virtual box if used and 👌 add them to the
system explained above
Poker apps usually run on W7 or higher
VirtualBox version 7.0.12
or higher with its 👌 respective expansion pack
Running via docker
$ git clone
//github/dickreuter/Poker.git
$ cd Poker
$ docker compose up -d
$ xhost
local:root # This permits the 👌 root user on the local machine to connect to X windows
display
$ docker-compose exec app python3 main.py # once the 👌 container is running you
can launch the bot with this command
Running via python source code
Download pycharm
communite edition as an 👌 IDE from here:
//jetbrains/pycharm/download/#section=windows
Install anaconda
//anaconda/products/distribution
Create an environment with pip install -r
requirements.txt and separately run pip install tesserocr
and separately 👌 run pip
install tesserocr You also may need to get c++ runtime distributable:
//visualstudio.microsoft/downloads/
Install virtualbox from
//virtualbox/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)
Packages and modules:
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 mapping
: Functions to
recognize the different items on the table, based on the created mapping
screen_operations 👌 : Various routines, such as taking screen shots, cropping etc
:
Various routines, such as taking screen shots, cropping etc table_setup 👌 : Routines in
relation to the gui
: Routines in relation to the gui ui_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 input
: The ultimate
decision what action should 👌 be taken based on the input montecarlo_numpy2.py : fast
numpy based montecarlo simulation to calculate equity. Not yet working correctly. 👌 Some
tests are failing. Feel free to fix them.
: 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 montecarlo
: tests for the numpy montecarlo test_pylint.py : pylint
👌 and pydoc tests to ensure pep8 standards and static code analysis
Graphical user
interface (gui)
Download QT for open source project:
//qt.io/download-open-source
Use 👌 the qt designer to edit any of the .ui files in
gui/ui
Next Priorities
[ ] 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
Making fixes in the code
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)
(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:
//stackoverflow/questions/19329601/interactive-shell-debugging-with-pycharm
Commi
t 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
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!]
FAQ
No top left corner
Make sure everything looks exactly like in the
picture 👌 at the top of this documentation. The buttons need to look exactly like this
and it needs to be in 👌 English and not scaled. Colours need to be standard. Most tables
are mapped to real money. They won't work with 👌 play money. 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.
Tables are mapped for fast
forward and zoom games with real money. Use the 👌 Supersonic3 table for Partypoker or
McNaught table in Pokerstars.
If things still don't work, consider teaching it a new
table as 👌 described above.
Cards not recognized
Make sure everything looks exactly like
in the picture at the top of this documentation. Make sure 👌 to use real money. Tables
are different for play money. Ensure you are seated at the position as shown in 👌 the
picture above. Currently the bot only works for tables with 6 players.
Do I need to use
a virtual machine?
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.
Analyzing the log and reporting problems
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
//github/dickreuter/Poker/issues or 👌 email dickreuter@gmail.
Related
projects
Training the bot by playing against itself is a separate project which can be
found here: //github/dickreuter/neuron_poker
