File size: 1,760 Bytes
b629477 c783a58 b629477 abc64eb b629477 cc8f439 b629477 c783a58 c789271 c783a58 c789271 c783a58 c789271 c783a58 c789271 c783a58 cc8f439 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 | ---
title: Chess
emoji: ♟️
colorFrom: purple
colorTo: gray
sdk: gradio
sdk_version: 5.50.0
app_file: app.py
pinned: false
license: mit
short_description: Play against chess-playing reasoning LLM
---
# ♔ Chess Reasoner
Play chess against a reasoning LLM! This demo showcases **[nuriyev/chess-reasoner-grpo](https://huggingface.co/nuriyev/chess-reasoner-grpo)**, a Qwen3-4B model tuned to play chess with detailed reasoning traces.
## 🎮 How to Play
1. **You play as White** - click on pieces to move them
2. **AI plays as Black** - the model will respond with its move
3. **View AI Reasoning** - expand the "🧠 AI Reasoning" accordion to see the model's thought process
4. **AI First** - click this button if you want the AI to play White instead
## 🧠 Model Details
| Attribute | Value |
|-----------|-------|
| Base Model | [Qwen/Qwen3-4B-Instruct-2507](https://huggingface.co/Qwen/Qwen3-4B-Instruct-2507) |
| Training | SFT with LoRA (r=32) on reasoning traces |
| Dataset | [aicrowd/ChessExplained](https://huggingface.co/datasets/aicrowd/ChessExplained) |
| Output Format | `<reason>...</reason><uci_move>move</uci_move>` |
## 📋 Output Format
The model outputs structured reasoning:
```
<reason>The opponent left their queen undefended. Taking it wins material.</reason>
<uci_move>d4d8</uci_move>
```
## ⚠️ Limitations
Model is still very bad at playing chess! I am working on creating a beast. Coming soon...
## 🔗 Links
- [Model Card](https://huggingface.co/nuriyev/chess-reasoner)
- [LoRA Adapter](https://huggingface.co/nuriyev/chess-reasoner-lora)
- [Training Dataset](https://huggingface.co/datasets/nuriyev/chess-reasoning)
- [Training Code](https://colab.research.google.com/drive/1koRx4Aa8AzA1HGwvEFYll9dWmw0hyVzo) |