Skip to content

Backgammon engine based on neural networks

License

Notifications You must be signed in to change notification settings

macherius/wildbg

 
 

Repository files navigation

wildbg

wildbg is a backgammon engine based on neural networks. Currently, it's in alpha stage.

As of November 2023, it reaches an ELO rating of roughly 1800 and an error rate mEMG of roughly 7.5 when being analyzed with GnuBG.

For discussions, please join the Discord Server Computer Backgammon Discord Shield.

Goals

  1. Provide source code and documentation to train neural nets from zero to super human strength.
  2. Implement logic to evaluate all kind of backgammon positions: cubeless and cubeful equities, multi-ply evaluation, rollouts, etc.
  3. Make the backgammon engine accessible via an easy-to-use HTTP JSON API.

A graphical user interface (GUI) is not part of this project.

Try it out

FIBS

Thanks to @oysteijo you can play against wildbg on the backgammon server FIBS. As FIBS client I recommend JavaFibs.

bgammon.org

Thanks to @tslocum you can play against BOT_wildbg on his new backgammon server https://bgammon.org. The source code of the bot can be found here.

Online API

You can access the API and see yourself how wildbg would move: https://wildbg.shuttleapp.rs/swagger-ui/

An example for the starting position and rolling 3 and 1: https://wildbg.shuttleapp.rs/move?die1=3&die2=1&p24=2&p19=-5&p17=-3&p13=5&p12=-5&p8=3&p6=5&p1=-2

Locally

Install Rust on your machine and then execute cargo run or cargo run --release. A web server will be started which you can access via http://localhost:8080/swagger-ui/

Beware that the networks committed to this repository are very small networks just for demonstration purposes. You can find the latest training progress and networks here: https://github.com/carsten-wenderdel/wildbg-training

Documentation

For users (bots and GUIs)

For contributors

Also see the CHANGELOG for a list of changes.

Contributing

Help is more than welcome! There are some smaller tasks but also bigger ones, see https://github.com/carsten-wenderdel/wildbg/issues. Currently, most needed is:

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

Backgammon engine based on neural networks

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 95.8%
  • Python 2.7%
  • C 1.5%