README.asciidoc
July 5, 2025 · View on GitHub
== Black Hole Solitaire Solver
http://www.shlomifish.org/open-source/projects/black-hole-solitaire-solver/[Black Hole Solitaire Solver] is an automated solver for the card Solitaire games https://en.wikipedia.org/wiki/Golf_%28patience%29[“Golf”], http://en.wikipedia.org/wiki/Black_Hole_%28solitaire%29[“Black Hole”], and http://en.wikipedia.org/wiki/All_in_a_Row_%28Solitaire%29[“All in a Row”] .
https://github.com/shlomif/black-hole-solitaire/actions[image:https://github.com/shlomif/black-hole-solitaire/actions/workflows/use-github.actions.yml/badge.svg[GitHub Actions Build Status]]
=== Screenshots
image::http://i.imgur.com/htp5UZq.jpg[Running using PySol FC on KDE Plasma 5]
==== Videos
https://www.youtube.com/watch?v=t_cuDHj5V2k&feature=youtu.be[Solving Black Hole in PySolFC]
=== Guide to the code
The interesting code in C is under the black-hole-solitaire/c-solver/ directory. There’s also some code in Perl under black-hole-solitaire/Games-Solitaire-BlackHole-Solver/ which is slower and consumes more RAM, and which has been used for prototyping interesting features.
Some related links:
- http://fc-solve.shlomifish.org/[Freecell Solver] - a solver for Freecell and related solitaire games.
- http://fc-solve.shlomifish.org/links.html#other_solvers[Other patience solvers]
=== CI Build+Tests