Phần mềm chơi cờ vua với AI mạnh và giao diện đẹp
⬇️ TẢI NGAY (354 MB)
Không cần cài Python! • Giải nén và chạy • Hoàn toàn offline
📋 Hướng dẫn chi tiết | 📝 Release Notes | 🎮 Tất cả phiên bản
- Phân tích vị trí real-time với AI
- Gợi ý nước đi tốt nhất
- Đánh giá chất lượng nước đi (!! → ??)
- Hiển thị 3 nước đi thay thế
- Thiết kế chuyên nghiệp, dễ nhìn
- Màu sắc brown/tan tối ưu
- Hiển thị nước đi hợp lệ (chấm xanh)
- Lịch sử nước đi 2 cột compact
- 12 cơ sở khai cuộc chuyên nghiệp
- Komodo, GM2600, Performance
- Tự động chọn nước đi từ sách
- Hiển thị tên khai cuộc + ECO code
- 538 files Syzygy tablebase
- Chơi tàn cuộc hoàn hảo (3-7 quân)
- Tự động probe khi phù hợp
- Minimax với alpha-beta pruning (C++)
- Độ sâu tìm kiếm 2-4 nước (configurable)
- ~100,000 nodes/giây
- LRU cache 1000 positions
Bước 1: Tải file ZIP
Bước 2: Giải nén vào thư mục bất kỳ
Bước 3: Chạy ChessAI-EuryEngine.exe
📖 Hướng dẫn đầy đủ cho người dùng
# 1. Clone repository
git clone https://github.com/EurusDFIR/chess-ai.git
cd chess-ai
# 2. Install dependencies
pip install -r requirements.txt
# 3. Run (v2.1 with Analysis Mode)
python -m src.gui.main_window_v2
# 4. Build executable (optional)
python build_release.py- OS: Windows 10/11 (64-bit)
- RAM: 512 MB (khuyên dùng 2GB)
- Ổ cứng: 400 MB trống
- Python: ❌ Không cần cài!
- Python: 3.12+ (khuyên dùng 3.12.4)
- OS: Windows/Linux/MacOS
- RAM: 2GB+
- Dependencies: Xem
requirements.txt
| Thao tác | Cách làm |
|---|---|
| Di chuyển quân | Click quân → Click ô đích |
| Kéo thả | Giữ chuột trái + kéo |
| Vẽ mũi tên | Chuột phải + kéo |
| Highlight ô | Click chuột phải |
| Hủy chọn | Nhấn ESC hoặc click ô trống |
| Toggle Analysis | Click "Analysis" hoặc phím A |
| Đầu hàng | Click "Resign" hoặc Ctrl+R |
| Xin hòa | Click "Draw" hoặc Ctrl+D |
| Ván mới | Click "Rematch" hoặc Ctrl+N |
| Về menu | Click "Home" hoặc ESC |
- ✅ Game Analysis Mode - Phân tích real-time
- ✅ Evaluation Bar - Thanh đánh giá vị trí
- ✅ Move Annotations - Đánh giá nước đi (!! → ??)
- ✅ Lichess UI - Giao diện mới chuyên nghiệp
- ✅ Opening Books - 12 cơ sở khai cuộc
- ✅ Syzygy Tables - 538 endgame files
- ✅ Board sync trong analysis mode
- ✅ UIScrollBar crash
- ✅ Evaluation bar calculation
- ✅ Move history SAN notation
- ✅ Control button rendering
┌─────────────────────────────────────┐
│ Python GUI Layer │
│ (Pygame CE 2.5.3) │
├─────────────────────────────────────┤
│ Component System │
│ ┌───────────────────────────────┐ │
│ │ BoardWidget │ │
│ │ ChessClock │ │
│ │ MoveHistoryWidget │ │
│ │ CapturedPiecesWidget │ │
│ │ EvaluationBar │ │
│ │ AnalysisPanel │ │
│ │ ControlPanel │ │
│ └───────────────────────────────┘ │
├─────────────────────────────────────┤
│ Game Logic Layer │
│ (python-chess 1.10.0) │
├─────────────────────────────────────┤
│ AI Engine Layer │
│ ┌───────────────────────────────┐ │
│ │ Minimax (C++ binding) │ │
│ │ Alpha-Beta Pruning │ │
│ │ Position Evaluation │ │
│ │ Opening Book Loader │ │
│ │ Syzygy Tablebase Probe │ │
│ │ Analysis Engine │ │
│ └───────────────────────────────┘ │
└─────────────────────────────────────┘
Tech Stack:
- Frontend: Pygame CE + pygame_gui
- Backend: python-chess
- AI: C++ minimax (Python binding)
- Threading: Queue-based async
- Caching: LRU cache (functools)
- Build: PyInstaller 6.16.0
- 📖 HUONG_DAN_TAI.md - Hướng dẫn tải và cài đặt
- 🎮 GAME_CONTROLS_GUIDE.md - Điều khiển game
- 🚀 QUICK_START.md - Bắt đầu nhanh
- 🏗️ HYBRID_ARCHITECTURE.md - Kiến trúc hệ thống
- 🎨 GUI_IMPROVEMENTS.md - Cải tiến UI/UX
- 🔨 BUILD_GUIDE.md - Build C++ engine
- ⚙️ CPP_IMPLEMENTATION_GUIDE.md - C++ implementation
- 📝 RELEASE_NOTES.md - Chi tiết v2.1.0
- 📊 OPTIMIZATION_REPORT.md - Performance analysis
Q: Tại sao file .exe lớn 98 MB?
A: File chứa:
- Python 3.12 runtime đầy đủ (40MB)
- Pygame CE + pygame_gui (25MB)
- python-chess library (10MB)
- C++ chess engine (5MB)
- Assets (fonts, icons) (3MB)
- Opening books (12MB)
- Syzygy tablebases (3MB compressed)
Lợi ích: Không cần cài Python, chạy ngay!
Q: Game có virus/malware không?
A: Hoàn toàn KHÔNG!
- Code nguồn mở 100% tại GitHub
- Build bằng PyInstaller (official tool)
- Không kết nối internet
- Không thu thập dữ liệu
- Có thể kiểm tra code trước khi build
Windows SmartScreen cảnh báo vì app chưa được Microsoft ký số ($300/năm).
Q: Có thể chơi offline không?
A: Có! Game hoàn toàn offline:
- Không cần internet khi chơi
- Opening books đã tích hợp sẵn
- Tablebases cũng offline
- Chỉ cần internet khi tải lần đầu
Q: Tại sao Analysis Mode chậm lần đầu?
A:
- Lần đầu: AI đang "khởi động" cache → 2-3 giây
- Từ lần 2: Dùng cache → < 1 giây
- Cache lưu 1000 positions (LRU)
Tip: Để Analysis Mode bật liên tục để cache warm-up.
Q: AI mạnh cỡ nào?
A:
- Easy (~1200 Elo) - Người mới chơi
- Medium (~1500 Elo) - Trung bình
- Hard (~1800 Elo) - Khá mạnh
- Expert (~2000 Elo) - Rất mạnh
Với opening books + tablebases, AI có thể đạt 2200+ Elo trong một số vị trí.
Q: Có bản MacOS/Linux không?
A: Hiện tại chỉ Windows 64-bit. Nhưng có thể:
- Chạy từ source code trên Mac/Linux (cần Python)
- Build từ source bằng PyInstaller
- Sắp tới sẽ có cross-platform build
# Trên Mac/Linux:
git clone https://github.com/EurusDFIR/chess-ai.git
cd chess-ai
pip install -r requirements.txt
python -m src.gui.main_window_v2Q: Làm sao báo lỗi?
A:
- Vào: https://github.com/EurusDFIR/chess-ai/issues
- Click "New Issue"
- Cung cấp:
- Windows version (10/11)
- Mô tả lỗi chi tiết
- Screenshot (nếu có)
- Các bước tái hiện lỗi
# Clone repo
git clone https://github.com/EurusDFIR/chess-ai.git
cd chess-ai
# Create virtual environment (khuyên dùng)
python -m venv venv
source venv/bin/activate # Linux/Mac
venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Run game
python -m src.gui.main_window_v2# Option 1: Use build script
python build_release.py
# Option 2: Manual PyInstaller
pyinstaller --name=ChessAI-EuryEngine \
--onefile --windowed \
--add-data="src/gui/assets:assets" \
--add-data="opening_bin:opening_bin" \
--hidden-import=pygame \
--hidden-import=chess \
src/gui/main_window_v2.pychess-ai/
├── src/
│ ├── ai/ # AI engine
│ │ ├── minimax_optimized.py
│ │ ├── evaluation.py
│ │ └── analysis_engine.py
│ ├── game/ # Game logic
│ │ ├── chess_game.py
│ │ └── move_validator.py
│ ├── gui/ # UI components
│ │ ├── components/
│ │ │ ├── board_widget.py
│ │ │ ├── evaluation_bar.py
│ │ │ ├── analysis_panel.py
│ │ │ └── ...
│ │ ├── main_window_v2.py
│ │ └── theme_improved.json
│ └── utils/ # Utilities
├── opening_bin/ # Opening books (12 files)
├── syzygy/ # Tablebases (538 files)
├── build_release.py # Build script
├── requirements.txt # Dependencies
└── README.md # This file
# Run tests
python -m pytest tests/
# Test AI engine
python test_current_engine.py
# Benchmark
python benchmark_engines.pyContributions welcome! 🎉
- Fork repo này
- Clone fork của bạn:
git clone https://github.com/YOUR_USERNAME/chess-ai.git - Tạo branch:
git checkout -b feature/TinhNangMoi - Commit:
git commit -m 'Thêm tính năng ABC' - Push:
git push origin feature/TinhNangMoi - Tạo Pull Request trên GitHub
- MacOS/Linux build
- Online multiplayer
- Puzzle mode
- PGN import/export
- Custom themes
- Sound effects
- Tournament mode
- Neural network engine
MIT License - Xem LICENSE file
MIT License
Copyright (c) 2025 Eury Engine Team - TDMU
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
Tóm tắt:
- ✅ Sử dụng miễn phí (cá nhân, thương mại)
- ✅ Sửa đổi tùy ý
- ✅ Phân phối lại
- ✅ Dùng cho mục đích thương mại
⚠️ Không bảo hành, tự chịu trách nhiệm
Thông tin cần cung cấp:
- Windows version (10/11, 64-bit?)
- Python version (nếu chạy từ source)
- Mô tả lỗi chi tiết
- Screenshot (nếu có)
- Các bước tái hiện
- 📧 Email: (thêm email nếu muốn)
- 💬 GitHub Discussions: https://github.com/EurusDFIR/chess-ai/discussions
- 🐛 Issues: https://github.com/EurusDFIR/chess-ai/issues
Eury Engine Team - Trường Đại học Thủ Dầu Một (TDMU)
- 🏫 Trường: TDMU - Thủ Dầu Một University
- 👤 GitHub: @EurusDFIR
- 📦 Repository: chess-ai
- 📅 Năm: 2024-2025
- 📚 Môn học: Trí tuệ nhân tạo (AI)
- python-chess - Niklaus Fiekas - Chess logic và move generation
- Pygame CE - Pygame Community - Graphics engine
- pygame_gui - Dan Lawrence - UI framework
- PyInstaller - PyInstaller Team - Executable builder
- Syzygy Tablebases - Ronald de Man - Endgame tablebases
- Polyglot Opening Books - Fabien Letouzey - Opening book format
- Lichess - UI design inspiration
- Chess Programming Wiki - Chess AI resources
- 🎓 TDMU - Đại học Thủ Dầu Một
- 👨🏫 Giảng viên môn AI - Hướng dẫn và support
- 🧑💻 Contributors - Tất cả những người đóng góp code
- ☕ Coffee - Động lực coding ban đêm
♟️ Chúc bạn chơi vui! 🎮
Developed with ❤️ by Eury Engine Team - TDMU 2024-2025
Môn học: Trí tuệ nhân tạo • Khoa Công nghệ thông tin
⭐ Nếu thích project này, hãy cho 1 star trên GitHub! ⭐ │ │ ├── components/ # NEW: Modular widgets │ │ ├── main_window_v2.py # NEW: Refactored main │ │ ├── main_window.py # Old version │ │ └── theme_improved.json # NEW: Better theme │ ├── ai/ # AI algorithms │ └── engine_cpp/ # C++ engine (optional) ├── docs/ # NEW: Documentation folder ├── opening_bin/ # Opening books └── requirements.txt
## 🐛 Changelog
### v2.0 (Current)
- ✅ Refactored GUI to component-based architecture
- ✅ Fixed clock functionality with proper increment
- ✅ Organized all documentation files
- ✅ Improved UI/UX with Lichess-style design
- ✅ Added move history with SAN notation
- ✅ Better visual feedback and animations
### v1.0
- Initial release with basic functionality
## 📝 License
MIT License
## 👨💻 Author
**EurusDFIR**
- GitHub: [@EurusDFIR](https://github.com/EurusDFIR)
---
⭐ **Star this repo if you like it!**
See [README_V2.md](README_V2.md) for detailed documentation.