Chess AI Agent —
Real-Time Hints & Analysis
Get move suggestions powered by Stockfish 16 with plain-English explanations from Gemini AI. The agent identifies your game phase, retrieves relevant opening theory, and tells you exactly why the suggested move is best — in one clear sentence.
What the Agent Does
Stockfish 16 Engine
Industry-standard chess engine with depth-15 analysis gives you grandmaster-strength move suggestions in under a second.
Opening Theory RAG
A 37-document knowledge base covers Sicilian Defence, King's Indian, Ruy López, French Defence, and more. The agent retrieves the most relevant opening theory for your position.
Gemini AI Explanations
Stockfish picks the best move; Gemini AI (2.5 Flash) writes a clear one-sentence explanation of why — naming the concrete tactical idea or positional plan.
Phase Detection
The agent automatically identifies whether you're in the opening, middlegame, or endgame based on material count and adjusts its knowledge retrieval accordingly.
Evaluation Bar
A visual white-vs-black advantage bar shows who is winning and by how much, updated with every hint.
Auto-Hint Mode
Turn on Auto mode and get a hint every time it's your turn without clicking — great for learning positions passively.
How to Use the Chess AI Agent
Follow these steps to activate the agent and start getting intelligent move hints during your game.
- 01
Create or Join a Room
Start a new private room or join an existing one with your friend's room code. No account needed — just pick a display name and jump in.
- 02
Open the AI Agent Panel
On desktop, the Chess AI Agent panel is visible in the right sidebar. On mobile, tap the Bot icon (🤖) in the top bar to open the agent bottom sheet.
- 03
Enable the Agent
Toggle the switch to "On". The agent activates and monitors your position. It works on any position at any point in the game.
- 04
Get a Hint
Click "Get Hint" when it's your turn. The agent runs Stockfish 16 to find the best move, then Gemini AI writes a one-sentence explanation of the tactical or positional idea.
- 05
Use Auto Mode
Enable Auto mode and the agent will automatically request a hint each time it's your turn — perfect for learning while you play.
- 06
Apply the Move
Click "Apply Move" on the suggestion card and the agent's recommended move is played on the board instantly.
How It Works Under the Hood
The agent runs a 4-stage AI pipeline on the server every time you request a hint:
- Board Reading: Your current FEN position is parsed and the game phase (opening / middlegame / endgame) is detected using material count.
- Knowledge Retrieval (RAG): A query embedding (Gemini Embedding 001) is matched against 37 chess knowledge documents. The top 3 most relevant passages — opening theory, tactics, endgame principles — are retrieved.
- Stockfish Analysis: Stockfish 16 at depth 15 evaluates the position and finds the best move along with its centipawn evaluation score.
- Gemini Explanation: Gemini 2.5 Flash receives the board state, retrieved knowledge, and Stockfish's best move — and writes one clear sentence explaining the concrete idea behind the move.
Frequently Asked Questions
Is the Chess AI Agent free to use?
Yes. The agent is completely free. It uses the Gemini API on its free tier — up to 15 requests per minute and 1,500 per day, which is more than enough for casual play.
How strong is the AI's move analysis?
The move suggestion comes from Stockfish 16 at depth 15, which plays at a grandmaster level (estimated 2800+ Elo). The AI agent is meant as a learning tool, not for competitive cheating.
Does the agent see my opponent's clock or moves?
The agent only sees the current board position (FEN) and your move history. It does not have access to your opponent's camera, time, or private information.
Can I use the agent on mobile?
Yes. Tap the Bot icon in the mobile top bar to open the agent as a bottom sheet. It works identically to the desktop sidebar panel.
What chess openings does the agent know about?
The knowledge base includes Sicilian Defence, King's Indian Defence, Ruy López, French Defence, Queen's Gambit, Nimzo-Indian, Caro-Kann, Italian Game, Pirc Defence, Dutch Defence, and general opening principles.
Can I apply the agent's suggested move automatically?
Yes — click "Apply Move" on the suggestion card to play the move instantly. In Auto mode, you can also choose to apply moves automatically each turn.
Ready to play smarter?
Create a room, invite a friend, and let the AI agent guide your game — free, no signup.