awesome-xiangqi
github.com/lucaferranti/awesome-xiangqi ↗An awesome list of xiangqi related resources
Use this list with your AI agent
Add the Context Awesome MCP server to Claude, Cursor, or any MCP client, then ask:
"Show me endgames resources from awesome-xiangqi"
Installation instructions →What's inside
Games databases
Computer xiangqi
- A completed implementation for xiangqi rules
Paper describing an algorithm to check for perpetual check and perpetual chasing.
- Chinese chess encyclopedia
Overview of some computer xiangqi concepts and description of ECCO opening classification.
- Chinese Chess File Format
Description of the WXF format by WXF.
- Computer Chinese Chess
Overview of the field. A bit old, but still relevant for the basic concepts.
- Tsan-sheng Hsu page
Lecture notes and several research papers on computer xiangqi.
- Xiangqi chess engine in JavaScript
Video tutorials on developing a simple xiangqi engine from scratch in JavaScript.
Books
- A study of the cannon-pawn treatiseEndgames
- A study of the chariot-horse treatiseEndgames
- A study of the horse-pawn treatiseEndgames
- Basic xiangqi chekmate methodsTactics / puzzles
Free ebook by WXF about common checkmate techniques.
- Become a xiangqi assassin 1Tactics / puzzles
Exercise book with several puzzles with discussed solutions in increasing level of difficulty.
- Become a xiangqi assassin 2Tactics / puzzles
Exercise book several puzzles with discussed solutions in increasing level of difficulty.
YouTube channels
- Chengdi shen
Several game reviews and lessons in Chinese.
- Globalization of xiangqi
Endgame explanations and exercises.
- Learning Chinese chess
Lessons on concepts and game commentaries.
- Shiro speaks chess
Games commentaries in Chinese with English subtitles.
- Sim Yip How channel
Some game reviews in English.
- Singapore xiangqi academy
Lessons on some openings.
Websites to play
- ClubXiangqi
no
- Elephantchess.io
pikafish or fairy-stockfish, multiple levels
- Mistboard
pikafish, pikajieqi and fairy-stockfish, multiple levels
- PlayOK
no
- PyChess
fairy-stockfish, multiple levels
- Xiangqi.com
pikafish, multiple levels
Social
- Elephantchess.io discord server
To find opponents and chat with the site developer.
- Fairy-stockfish discord server
It has a channel dedicated to xiangqi.
- Pikafish discord server
To discuss pikafish development.
- PyChess discord server
It has channel dedicated to xiangqi, to discuss about the game and find an opponent.
- r/xiangqi
Subreddit for xiangi related discussions.
- Xiangqi.com discord server
To find opponents and chat with the site developers.
Engines
- Fairy-stockfish
Strong engine based on stockfish, which also supports other chess and xiangqi variants.
- Pikafish
Strong engine for xiangqi based on stockfish.
Other useful tools
- Mistboard board editor
Browser board editor for xiangqi and several of its variants. Set up a position by hand or paste a FEN, then get a shareable link and a rendered position image.
- xiangqi-book-example
LaTeX template to write text about xiangqi, using
- xiangqi-setup
Python script to generate board images from FEN or WXF formats.
- 棋弈江湖 (Xiangqi PWA)
Full-featured xiangqi platform with the world's first open-source board recognition system. Includes complete ONNX models for chess piece detection and classification, AI analysis powered by Pikafish, 7300+ puzzle database, and professional game review. All models are MIT licensed.
Showing a sample of 76 resources. View the full list on GitHub →