cmd-game-chess 0.1.5

A simple command-line chess game!

CMD Chess Game ♟️

      __   __   __
    /   \/   \/   \
   | v   v   v   v |
    \  \   .   /  /
     \__\_/_\_/__/
     |           |
     |( ) ( ) ( )|
     |___________|
          ___
         (   )
          ) (
         /   \
        (     )
         )   (
        /     \
       (_______)

---

A lightweight, cross-platform terminal-based chess game written in Python. Play against a positional AI right in your command line!

Features

• Cross-Platform: Automatic rendering for Windows (ASCII/Unicode) and Linux/macOS.
• Smart AI: An integrated chess bot with positional evaluation.
• Input Validation: Robust error handling for illegal moves and non-numeric menu inputs.
• Easy Installation: Fully compatible with pip and PyPI.
• Save/Load System: Support for saving your game state to resume later.

Installation

Install via pip:

You can install the game directly from PyPI. Ensure you have Python 3.10 or higher installed.

1. Install the package:

pip install cmd-game-chess

2. Run the game:

play-chess

Note: If the command play-chess is not found, use python -m cmd_chess.chess.*

Run from Source:

If you want to contribute or modify the code:

1. Clone the repository:

git clone https://github.com/Danil-gtj/cmd-chess.git
cd cmd-chess

2. Launch the script:

python src/cmd_chess/chess.py

Arch Linux (AUR):

For Arch Linux users, the package is available in the AUR:

yay -S python-cmd-game-chess

How to Play

Menu Controls:

Enter the corresponding number to navigate:

• 1 — Start Play: Enter the match against the AI.
• 2 — Save Game: Save your current board state.
• 3 — Load Game: Resume from your last save.
• 4 — Toggle Graphics: Switch between Unicode icons and ASCII letters (useful if figures appear as squares).
• 0 — Exit: Close the application.

In-Game Commands:

• Move pieces using standard coordinates (e.g., A2 to A4).
• Type EXIT at any time during your turn to return to the main menu.

Technical Details:

• Dependencies: None (Uses Python Standard Library only).
• Architecture: Modular structure with dedicated logic for piece movement, AI evaluation, and state persistence.