ref: d651ab6474d4380fb93500bb9e5ee681b51ac21f
dir: /README.md/
<!-- moonfish is licensed under the AGPL (v3 or later) --> <!-- copyright 2023 zamfofex --> moonfish === [](https://builds.sr.ht/~zamfofex/moonfish/commits/main) [](https://lichess.org/@/munfish/perf/rapid) [](https://lichess.org/@/munfish/perf/blitz) [](https://lichess.org/@/munfish/perf/bullet) **moonfish** is a chess bot inspired by [sunfish], written in C rather than Python. It is not nearly as complete, but it works well enough! [sunfish]: <https://github.com/thomasahle/sunfish> features --- - simple HCE based on PSTs - alpha/beta pruning search - cute custom UCI TUIs - custom Lichess integration - optional threaded search support (enabled by default) limitations --- These are things that I plan to fix eventually. - the bot will never make certain moves - no en passant - no underpromotion - the TUI will also prevent you from making those kinds of moves - no transposition table - no good move ordering heuristic - no support for `go infinite` or `go mate` - no move name or FEN validation (may lead to potential exploits) download --- Prebuilt executables for Linux of moonfish (and its tools) may be found at <https://moonfish.neocities.org> building --- ~~~ make moonfish ~~~ The two UCI TUIs, called “play” and “analyse”, may also be built. ~~~ make play analyse ~~~ usage --- moonfish is a UCI bot, which means you can select it and use it with any UCI program (though see “limitations” above). You can invoke `./moonfish` to start its UCI interface. However, note that moonfish comes with its own UCI TUIs, called “play” and “analyse”. You can use them with any UCI engine you’d like! To play against a UCI bot, use `./play` followed by a time control, then the command of whichever bot you want to play against. The color of your pieces will be decided randomly. ~~~ # (start a game against Stockfish) ./play 1+0 stockfish # (start a game against Leela) ./play 5+2 lc0 # (start a game against moonfish) ./play 15+10 ./moonfish ~~~ To analyse a game with an UCI bot, use `./analyse` followed by a FEN string (or `initial` for the starting position) in a single argument (use shell quotation marks if necessary) followed by the command of whichever bot you want to use for analysis. (Though note that moonfish currently does not have analysis capabilities.) ~~~ # (analyse a game using Stockfish) ./analyse initial stockfish # (analyse a game using Leela) ./analyse initial lc0 # (analyse a game using Leela, showing win/draw/loss evaluation) ./analyse initial lc0 --show-wdl ~~~ license --- [GNU][GPL] [AGPL] ([v3][AGPLv3] [or later][GPLv3+]) © [zamfofex 2023] [GPL]: <https://www.gnu.org/licenses/> [AGPL]: <LICENSE> [AGPLv3]: <https://www.gnu.org/licenses/agpl-3.0> [GPLv3+]: <https://www.gnu.org/licenses/gpl-faq.html#VersionThreeOrLater>