LibreBlackjack is a blackjack engine that emulates a dealer, deals (digital) cards and understands commands such as
stand. The basic idea is that one or more players can talk to LibreBlackjack either in an interactive or in an automated way through
These players can be actual human players playing in real-time through a front-end (a GUI application, a web-based interface, a mobile app, etc.) or robots that implement a certain betting and playing strategy playing (i.e. card counting) as fast as possible to study and analyze game statistics. There is an internal player that reads the strategy from a text file and plays accordingly. It can also be used to play interactive ASCII blackjack:
“I am often surprised that when people drive down two-lane roads, they will trust complete strangers in the oncoming lane not to swerve into their lane causing a head-on collision; but they will not trust mathematicians to create the correct strategy for Blackjack.”
With LibreBlackjack you do not have to trust other people anymore. You have a free blackjack engine which you can
Once you trust the blackjack engine is fair, you can model and simulate any blackjack situation you want, playing millions of times a certain hand (say a sixteen against a ten) in different ways (say hitting or standing) to obtain you own conclusions. You can even build the basic strategy charts from scratch to convince yourself there is no flaw.
The main objective is research and optimization of playing and betting strategies depending on
These automatic players can range from simple no-bust or mimic-the-dealer hitters or standers, up to neural-networks trained players taking into account every card being dealt passing through basic strategy modified by traditional card counting mechanisms.
sudo apt-get install git autoconf make gcc git clone https://github.com/seamplex/libreblackjack.git cd libreblackjack ./autogen.sh ./configure make sudo make install
Note that LibreBlackjack depends on two optional GNU libraries:
Run as test suite to check the code work as expected.
$ make check
players contains some automatic players that play against LibreBlackjack. These players are coded in different languages and communicate with LibreBlackjack in a variety of ways in order to illustrate the design basis:
yesthis player always says “stand” into the standard output (which is piped to libreblackjack’s standard input) no matter what the cards are
Run LibreBlackjack with no arguments to play Blackjack interactively in ASCII (actually UTF-8) mode.
Edit the file
blackjack.conf in the same directory where the executable is run to set up rules, arranged shoes and other options. Type
help at the prompt to get it.
The differential value of LibreBlackjack is that players can be programmed to play employing different strategies, card-counting techniques or even state-of-the-art AI algorithms.
See the directory
players for examples of how to write players in
To play through a TCP socket, call
netcat. On one host, do
nc -l -p1234 -e libreblackjack
On the other one, connect to the first host on port 1234:
nc host 1234
LibreBlackjack is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
Home page: https://www.seamplex.com/blackjack
Mailing list and bug reports: (you need to subscribe first at )
Follow us: Twitter YouTube LinkedIn GitHub
libreblackjack is copyright (C) 2016,2020 Jeremy Theler
libreblackjack is licensed under GNU GPL version 3 or (at your option) any later version.
libreblackjack is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
See the file
COPYING for copying conditions.