♟️ THE DAILY GRANDMASTER — Autonomous AI Chess Agent

“All the Chess News and Moves That’s Fit to Print”

An autonomous multi-level AI Chess Agent engineered with Minimax Alpha-Beta Pruning, Piece-Square Table (PST) Heuristics, Dynamic Opening Theory, Real-Time Agent Editorial Commentary, and an authentic Newsprint Design System.

Screenshots • Newsprint System • Features • AI Levels • Architecture • Quickstart • Author

---

📰 Editorial Interface & Screenshots

Front Page & Match Arena

The Daily Grandmaster Masthead, Live News Wire Marquee, Interactive Chessboard, and AI Agent Dispatch Column

Scoresheet & Colophon

Official Match Tournament Scoresheet, FEN / PGN Exporter, and Publication Colophon

---

🗞️ Newsprint Design Philosophy

The Newsprint aesthetic is an ode to the golden age of print journalism, reimagined for the modern web:

• Stark 0px Geometry: Absolute zero border radius. Every element is an authoritative rectangle with sharp 90-degree corners.
• High Information Density: Newspaper column grid layouts, collapsed borders, and tight typography.
• Editorial Typography:
  • Headlines & Masthead: Playfair Display serif with tight leading and tracking.
  • Body & Commentary: Lora serif with classic Drop Caps and justified reading alignment.
  • UI & Action Controls: Inter sans-serif with uppercase tracking-widest styling.
  • Metrics & Scoresheet: JetBrains Mono for engine depth, nodes, Elo ratings, and FEN/PGN records.
• Paper Palette: Warm #F9F9F7 aged paper background with subtle 4×4 dot grid texture, deep #111111 ink black text and borders, and #CC0000 editorial red accents.
• Hard Offset Shadows: Tactile cutout effect (box-shadow: 4px 4px 0px 0px #111111) on interactive hover elements.
• Live News Wire Marquee: Top ticker crawl broadcasting real-time match moves, opening theory classification, and in-check alarms.

---

🌟 Key Features

• ♟️ Full Standard Chess Engine: 100% pure TypeScript engine supporting legal moves, castling (kingside/queenside), en-passant captures, pawn promotions, in-check detection, checkmate, stalemate, 50-move rule, and 3-fold repetition.
• 🧠 Multi-Level Autonomous AI: 4 adaptive difficulty tiers (Beginner Elo 800 to Grandmaster Elo 2800+) powered by Minimax with Alpha-Beta pruning, MVV-LVA move ordering, and positional Piece-Square Tables (PST).
• 🎙️ Live Agent Chain-of-Thought & Editorial Commentary: Dynamic natural language breakdown of every move, tactical threat bulletins, and strategic positional critique.
• 📊 Vertical Balance Gauge (Evaluation Bar): Monospace gauge calculating the centipawn balance of power and mate sequences.
• 💡 Grandmaster Advice (Hint): In-game tactical coach delivering positional recommendations and reasoning.
• 📖 Opening Book Recognition: Real-time identification of opening lines (Sicilian Defense, Ruy Lopez, Queen's Gambit, French Defense, Caro-Kann, King's Indian, etc.).
• 📜 Official Match Scoresheet: Tournament move history table with instant Copy FEN and Download PGN functionality.
• 🏆 Special Extra Edition Game Review: End-of-game newspaper bulletin and match plies certificate.
• 🐍 Standalone Python CLI Chess Agent: Terminal ASCII chessboard with interactive play, depth tuning, and autonomous AI-vs-AI demo matches.

---

🎯 AI Difficulty Levels

Level	Title	Target Elo	Search Depth	Blunder Chance	Heuristic Profile
🥉 Beginner	Novice Bot	~800	Depth 2	25%	Casual play, basic material counting, friendly coaching advice.
🥈 Intermediate	Club Master	~1500	Depth 3	5%	Central control, active piece development, tactical fork awareness.
🥇 Master	Tactical Engine	~2200	Depth 4	0%	Minimax + Alpha-Beta pruning, king safety, pawn structure evaluation.
👑 Grandmaster	Autonomous GM Agent	~2800+	Depth 5+	0%	Deep tactical calculation, transposition tables, multi-turn strategic foresight.

---

🏗️ System Architecture

flowchart TD
    A[Human Move / Board Input] --> B[ChessEngine Validator]
    B --> C{Is Legal Move?}
    C -- No --> D[Reject & Retain Square]
    C -- Yes --> E[Apply Move & Update Board State]
    
    E --> F[Opening Book Matcher & FEN History]
    E --> G[ChessAgentService]
    G --> H[Generate Editorial Commentary & Threat Bulletins]
    
    E --> I{Is AI Turn?}
    I -- Yes --> J[ChessAI Engine]
    J --> K[Piece-Square Table Positional Heuristics]
    J --> L[Minimax Search with Alpha-Beta Pruning]
    L --> M[Select Optimal Move & Calculate PV]
    M --> E
    
    E --> N[Update Evaluation Bar & Scoresheet Notation]

Loading

---

🚀 Quickstart Guide

1. Clone the Repository

git clone https://github.com/Ishant6565/CHESS-AI.git
cd CHESS-AI

2. Launch the Web Application

# Install NPM dependencies
npm install

# Start the Vite development server
npm run dev

Open your browser at http://localhost:5173 to read the daily dispatch and play against the autonomous grandmaster!

---

🐍 Standalone Python CLI Agent

You can also challenge the AI directly in your terminal:

# Install Python dependencies
pip install -r requirements.txt

# Play as White against Intermediate AI
python chess_agent.py --level intermediate --color white

# Play as Black against Master AI
python chess_agent.py --level master --color black

# Run an Autonomous AI vs AI Demonstration
python chess_agent.py --level grandmaster --demo

---

📂 Project Structure

CHESS-AI/
├── docs/
│   └── screenshots/           # Editorial UI screenshots
├── src/
│   ├── chess/
│   │   ├── types.ts           # Chess types, moves, game state interfaces
│   │   ├── engine.ts          # Core chess rule validator & FEN/SAN generator
│   │   ├── ai.ts              # Minimax Alpha-Beta search & PST heuristics
│   │   └── openings.ts        # ECO opening book database & matcher
│   ├── services/
│   │   └── chessAgent.ts      # Real-time move commentary & coach hint service
│   ├── components/
│   │   ├── Navbar.tsx         # The Daily Grandmaster newspaper masthead
│   │   ├── ChessBoard.tsx     # 8x8 Newsprint interactive chessboard
│   │   ├── ChessPieces.tsx    # Crisp vector pieces with ink line contrast
│   │   ├── EvaluationBar.tsx  # Monospace metric balance gauge
│   │   ├── AgentHud.tsx       # Editorial dispatch column & drop caps
│   │   ├── MoveHistory.tsx    # Tournament scoresheet & PGN/FEN exporter
│   │   ├── GameReviewModal.tsx# Special Extra Edition match review certificate
│   │   ├── SettingsModal.tsx  # Board & match preference modal
│   │   └── Footer.tsx         # Publication colophon & credits
│   ├── App.tsx                # Breaking news marquee & 12-column layout
│   └── index.css              # Newsprint textures, dot grid & hard shadows
├── chess_agent.py             # Standalone Python CLI Chess Agent
├── requirements.txt           # Python dependencies
├── package.json               # NPM package metadata
├── tailwind.config.js         # Newsprint design tokens & typography
└── README.md                  # Project documentation & masthead

---

👤 Author

Crafted with dedication by Ishant6565.

• GitHub: @Ishant6565
• Repository: Ishant6565/CHESS-AI

---

📄 License

This project is licensed under the MIT License. Free to use, modify, and distribute.