Metadata-Version: 2.4
Name: python-chess-gui
Version: 0.1.2
Summary: A Python chess GUI application using pygame and python-chess with Stockfish support
Project-URL: Homepage, https://github.com/Bobain/python-chess-gui
Project-URL: Repository, https://github.com/Bobain/python-chess-gui
Project-URL: Issues, https://github.com/Bobain/python-chess-gui/issues
Author-email: Bobain <bobain@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: chess,game,gui,pygame,stockfish
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment :: Board Games
Requires-Python: >=3.12
Requires-Dist: chess>=1.11.2
Requires-Dist: pygame>=2.6.1
Description-Content-Type: text/markdown

# Python Chess GUI

![Demo](chess_demo.gif)

A Python chess application with a graphical user interface built using pygame and python-chess library, featuring player vs Stockfish AI gameplay.

## Features

- Player vs Stockfish AI gameplay
- Color selection (play as White or Black)
- Adjustable AI difficulty (Level 1-5)
- Move takeback (undo)
- Hint system (get Stockfish's suggested move)
- Real-time evaluation bar
- Visual highlights for legal moves, last move, and check

## Installation

### macOS

```bash
# Install Stockfish
brew install stockfish

# Install pipx and the game
brew install pipx
pipx ensurepath
source ~/.zprofile
pipx install python-chess-gui

# Run the game
chess-gui
```

### Debian/Ubuntu

```bash
# Install Stockfish
sudo apt install stockfish

# Install pipx and the game
sudo apt install pipx
pipx ensurepath
source ~/.bashrc
pipx install python-chess-gui

# Run the game
chess-gui
```

## Controls

- **Mouse click**: Select piece / move piece / menu selection
- **H**: Get a hint (Stockfish's suggested move)
- **Z**: Undo last move
- **N**: New game (return to menu)
- **Q / Escape**: Quit

## Development

Clone and run from source:

```bash
git clone git@github.com:Bobain/python-chess-gui.git
cd python-chess-gui
pip install -e .
chess-gui
```

## License

MIT License
