https://github.com/intothevoid/knightfight
A game of Chess written in Python
https://github.com/intothevoid/knightfight
chess game piece-square-tables pychess pygame pygame-games python-chess retro stockfish
Last synced: 7 months ago
JSON representation
A game of Chess written in Python
- Host: GitHub
- URL: https://github.com/intothevoid/knightfight
- Owner: intothevoid
- License: mit
- Created: 2023-01-30T12:15:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-04-27T05:28:39.000Z (over 2 years ago)
- Last Synced: 2025-01-19T21:38:40.847Z (9 months ago)
- Topics: chess, game, piece-square-tables, pychess, pygame, pygame-games, python-chess, retro, stockfish
- Language: Python
- Homepage:
- Size: 47.2 MB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Knight Fight
> "Join the battle as a valiant knight, outsmart your opponent, and capture the enemy's king in this strategic and knightly game of Knight Fight Chess."
Play chess on a pixelated retro board. Play against a CPU player or another friend.
Grid lines and positions overlay (configurable)
## Features
1. Multiple modes - Human v Human, CPU v Human, CPU vs CPU
2. Follows standard Chess rules (Now powered by python-chess)
3. Retro sound effects and music!
4. Lots of configurable options
5. Debug mode to highlight positions and grid
6. Undo last move (press Ctrl+Z)
7. Change board styles
8. Multiplayer API available. See https://www.github.com/intothevoid/chessapi for details.
9. Animated CPU piece moves
10. Retro title menu with options to save and load games
11. Smarter CPU player with multiple chess engines supported:
- Stockfish
- OpenAI API
- Piece Squares (Uses minimax algorithm)
- Piece Squares v2 (Uses minimax algorithm) - Default
- Basic Random Moves
12. Show possible moves for selected piece, and last move made
## Installation
```bash
git checkout git@github.com:intothevoid/knightfight.git
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
## Usage
```bash
python3 main.py
```
## Optional - Use Stockfish (Powerful Chess Engine)
If you would like to play against a stronger CPU player, you can install Stockfish. Stockfish is a free, open source chess engine. It is the strongest chess engine in the world.
1. Go to https://stockfishchess.org/download/ and download your version of the Stockfish chess engine
2. Copy the binary to assets/engines/stockfish (assets\engines\stockfish.exe for Windows)
3. Update the path in config.yml as shown below
### config.yml - Windows
```
cpu:
stockfish_path: assets/engines/stockfish.exe
```
### config.yml - MacOS / Linux
```
cpu:
stockfish_path: assets/engines/stockfish
```
## Optional - Use OpenAI API (GPT 3.5 powered chess engine)
If you would like to play against OpenAI's GPT 3.5 powered chess engine, you can install the OpenAI API. OpenAI is a powerful AI API that can be used to generate text, images, and more.
1. Set up an OpenAI account at https://beta.openai.com/
2. Copy your API key to config.yml as shown below OR setup an environment variable called OPENAI_API_KEY
3. Update the path in config.yml as shown below (chess engine option)
### config.yml (OpenAI settings)
```
cpu:
ai: openai
openai_api_key:
```
## Powered By
PyGame https://www.pygame.org/
OpenAI https://www.ai.com/
Stockfish https://github.com/official-stockfish/Stockfish
Stockfish GPL 3.0 License - See https://github.com/official-stockfish/Stockfish/blob/master/Copying.txt
Stockfish Source Code - https://github.com/official-stockfish/Stockfish/tree/master/src
Dani Maccari's image assets https://dani-maccari.itch.io/
Music assets by wyver https://wyver9.itch.io/8-bit-beatem-up-soundtrack
Midjourney - Knight Fight Splash Image https://midjourney.com/
python-chess - https://python-chess.readthedocs.io/en/latest/
Simplified Evaluation Function - https://www.chessprogramming.org/Simplified_Evaluation_Function