README
¶
Piñata (v1.11)
Piñata is an interactive shell to play blindfold chess against computers. Install any UCI compatible chess engine like Stockfish in the standard executable search path and Piñata will pick it up.
Docker Container
Run Piñata in a docker container with stockfish engine.
sudo docker run -it abperiasamy/pinata:latest
Download
| OS | Arch | Link |
|---|---|---|
| GNU/Linux | Intel (64-bit) | Download |
| GNU/Linux | Arm (64-bit) | Download |
| GNU/Linux | Arm (32-bit) | Download |
| Windows | Intel (64-bit) | Download |
| Darwin | Intel (64-bit) | Download |
| FreeBSD | Intel (64-bit) | Download |
Usage
Flags:
-a, --analyze string lichess.org API access-token to analyze the game
-b, --black choose the black side
-d, --depth int engine search depth (default 10)
-e, --engine string path to UCI compatible chess engine executable (default "stockfish")
-f, --file string load game from a PGN file
-h, --help help for pinata
-l, --light invert the colors for lighter console background
--no-color disable colors
--version version for pinata
-v, --visual cheat blindfold
Playing Blind
By default, the computer engine plays black. You make your first move. Use to auto-complete possible moves or commands.
$ ./pinata
█ 🙇 e4
░ 🤖 e6
█ 🙇 Nf3
░ 🤖 d5
█ 🙇 <TAB>
Ke2 Qe2 Rg1 Be2 Bd3 Bc4 Bb5+ Ba6 Na3 Nc3 Ng1 Nd4 Nh4 Ne5 Ng5
a3 a4 b3 b4 c3 c4 d3 d4 g3 g4 h3 h4 exd5 e5 resign
/fen /save /load /visual /quit /keys /fen /visual /quit /keys
Playing Visual
You can cheat the blindfold with --visual flag and play interactively. Use /visual command to toggle the board display during the practice sessions to verify your memory.
$ ./pinata --visual
█ 🙇 e4
░ 🤖 e6
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ │ A │ B │ C │ D │ E │ F │ G │ H │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 8 │ ♖ │ ♘ │ ♗ │ ♕ │ ♔ │ ♗ │ ♘ │ ♖ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 7 │ ♙ │ ♙ │ ♙ │ ♙ │ │ ♙ │ ♙ │ ♙ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 6 │ │ │ │ │ ♙ │ │ │ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 5 │ │ │ │ │ │ │ │ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 4 │ │ │ │ │ ♟ │ │ │ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 3 │ │ │ │ │ │ │ │ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 2 │ ♟ │ ♟ │ ♟ │ ♟ │ │ ♟ │ ♟ │ ♟ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
│ 1 │ ♜ │ ♞ │ ♝ │ ♛ │ ♚ │ ♝ │ ♞ │ ♜ │
┼───┼───┼───┼───┼───┼───┼───┼───┼───┼
█ 🙇
Contribute to Piñata Project
Please follow Piñata Contributor's Guide
Credits
- Chess library by Logan Spears (notnil)
- UCI library by Eve Freeman (freeeve)
License
Piñata is free software, licensed under GNU AGPL v3 or later
Documentation
¶
Overview ¶
Copyright © 2020 Anand Babu Periasamy https://twitter.com/abperiasamy
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
Source Files
Directories