update readme
Browse files
README.md
CHANGED
@@ -9,5 +9,51 @@ sdk_version: 5.33.0
|
|
9 |
app_file: app.py
|
10 |
pinned: false
|
11 |
license: apache-2.0
|
12 |
-
short_description:
|
13 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9 |
app_file: app.py
|
10 |
pinned: false
|
11 |
license: apache-2.0
|
12 |
+
short_description: Interactively play and chat chess against a Large Language Model (LLM)
|
13 |
---
|
14 |
+
|
15 |
+
# Chess Agent ♟️🤖
|
16 |
+
|
17 |
+
**Interactively play and chat chess against a Large Language Model (LLM).**
|
18 |
+
|
19 |
+
---
|
20 |
+
|
21 |
+
## What is Chess Agent?
|
22 |
+
|
23 |
+
Chess Agent is an interactive chess-playing interface integrated with LLM capabilities. Unlike traditional LLM interfaces, Chess Agent allows you to:
|
24 |
+
|
25 |
+
* **Play moves** directly on an interactive chessboard.
|
26 |
+
* **Chat with the agent** via text messages, exploring its chain-of-thought in real-time.
|
27 |
+
* **View strategic analysis** and tactical insights during gameplay.
|
28 |
+
|
29 |
+
## Key Features 🚀
|
30 |
+
|
31 |
+
* **Interactive Chessboard:** Make moves or set custom positions seamlessly.
|
32 |
+
* **Chat-based Interaction:** Communicate with the LLM directly, asking questions and receiving thoughtful responses.
|
33 |
+
* **Transparent Reasoning:** See step-by-step position analysis, the agent's internal reasoning, and the tool calls it performs in the background.
|
34 |
+
|
35 |
+
## How Does it Work? 🧠
|
36 |
+
|
37 |
+
Chess Agent leverages advanced tools:
|
38 |
+
|
39 |
+
* [**Custom Gradio Component:**](https://huggingface.co/spaces/Agents-MCP-Hackathon/gradio_chessboard) The interactive chessboard interface is implemented as a custom component in Gradio, enabling seamless interaction between board moves and LLM responses.
|
40 |
+
* [**Chess MCP Server:**](https://huggingface.co/spaces/Agents-MCP-Hackathon/chess-mcp-server) Provides position analysis using chess engines and heuristic evaluations.
|
41 |
+
* **Lichess Opening Database Integration:** Allows the agent to reference well-established chess opening theory.
|
42 |
+
|
43 |
+
These integrations compensate for LLMs' typical limitations in chess-playing ability, ensuring accurate and meaningful gameplay and analysis.
|
44 |
+
|
45 |
+
## Use Cases
|
46 |
+
|
47 |
+
* **Educational Tool:** Understand chess strategies and tactics through the transparent reasoning process.
|
48 |
+
* **Interactive Chess Assistant:** Improve your chess skills by interacting and querying the AI for explanations and insights.
|
49 |
+
* **Fun & Engagement:** Enjoy the novelty of playing against a language model and seeing how it thinks.
|
50 |
+
|
51 |
+
## Demo Video 🎬
|
52 |
+
|
53 |
+
See Chess Agent in action:
|
54 |
+
|
55 |
+
[▶️ Watch the Full Demo on YouTube](https://youtu.be/YiXHhrfvxqU)
|
56 |
+
|
57 |
+
---
|
58 |
+
|
59 |
+
Enjoy playing chess in a unique, insightful, and conversational way with Chess Agent!
|