Download and usage

Download Pikafish

Note

Pikafish is a command line program. You may want to use it in your own UCI-compatible xiangqi GUI.
Developers should communicate with Pikafish via the UCI protocol.

Get started

1. First download Pikafish. Pikafish itself is completely free with all its options.
2. Next, download a GUI (Graphical User Interface) as it is needed to conveniently use Pikafish. There are multiple free and commercial GUIs available. Different GUI's have more or less advanced features, for example, an opening explorer or automatic game analysis.
3. Now Pikafish must be made available to the GUI. Install in a Xiangqi GUI explains how this can be done for some of them. If a different GUI is used, please read the GUI's manual.
4. Ultimately, change the default settings of Pikafish to get the best possible analysis.

---

Official downloads

Latest release

https://pikafish.org/

Binaries are also available on GitHub: https://github.com/official-pikafish/Pikafish/releases/latest

Latest development build

1. Navigate to our actions
2. Choose the latest run
3. Scroll to the bottom
4. Download your preferred binary

Note

We only recommend downloading from the official GitHub releases.
Websites such as 棋中论坛 are third parties, so we cannot guarantee the safety, reliability, and availability of those binaries because we are not responsible for them.

Choose a binary

In order of preference:

1. x86-64-vnni512
2. x86-64-avx512
   • AMD: Zen 4 and newer (e.g. Ryzen 9 7950X).
3. x86-64-avx512f
4. x86-64-avxvnni
5. x86-64-bmi2
   • Intel: 4th Gen and newer (e.g. i7 4770K, i5 13600K).
   • AMD: Zen 3 (e.g. Ryzen 5 5600X).
6. x86-64-avx2
   • AMD: Zen, Zen+, and Zen 2 (e.g. Ryzen 5 1600, Ryzen 5 3600).
7. x86-64-sse41-popcnt

---

Download a Xiangqi GUI

A xiangqi graphical user interface allows you to interact with the engine in a user-friendly way. Popular GUIs are:

Free

Computer

SharkChess How to install Pikafish Change settings	XBoard (source code) How to install Pikafish Change settings

Online

Note

If you don't want to download a GUI, you can also use some of the available online interfaces. Keep in mind that you might not get the latest version of Pikafish, settings might be limited and speed will be slower.

XiangqiAI Change settings

---

Install in a Xiangqi GUI

SharkChess

1. Engines > Engines Settings

   

2. Switch to Engines Management tab and click the add button

   

3. Select and open the Pikafish executable

   

XBoard

1. Install uci2wb

   For Ubuntu distributions: sudo apt install uci2wb For other distros, clone and build uci2wb:

   git clone 'http://hgm.nubati.net/git/uci2wb.git'
   cd uci2wb
   make uci2wb
   make prefix=/usr install
   

2. Configure Pikafish as Xboard engine

   Engine > Load New 1st Engine...

   

Important

• Engine Command is uci2wb pikafish
• Make sure the first three boxes are unchecked

---

Change settings

Note

Please check our FAQ guide to set the optimal settings.

SharkChess

• Click the configure button

  

Xboard

• Engine > Engine #1 Settings...

  

Important

Make sure EvalFile field is configured and pointed to the correct Pikafish NNUE file. If you don't configure this field or the path to the file is wrong then the engine will die.

XiangqiAI

• Click the setting button

  

• Engine Settings