This is a standalone chess AI built around the Stockfish engine, designed for use by Eve, an AI VTuber that I am making. The goal of this project is to allow Eve to play entertaining, fair, and challenging games of chess against human players and show a range of skill levels in her moves.

Eve will use this AI module to:

• Play chess live on Twitch or YouTube.
• Compete against viewers or guests.
• Adjust her strength dynamically during the game (800, 1500, 2500 Elo).
• Occasionally make human-like mistakes (blunders) and brilliant moves to simulate natural gameplay and unpredictability.

This module is intended to be integrated into the main [Eve project (Private Repository)] but can also be used as a standalone chess AI.

• ✅ Based on the Stockfish chess engine.
• ✅ Adjustable play strength (800, 1500, 2500 Elo).
• ✅ Configurable randomness to simulate human play (blunders, inaccuracies, brilliancies).
• ✅ Simple API to plug into Eve's main codebase or other bots.
• ✅ Works with UCI-compatible interfaces.

1. Clone the repository:

   git clone https://github.com/your-username/eve-chess-ai.git
   cd eve-chess-ai

2. Download Stockfish:

• Official Stockfish releases
• Place the Stockfish binary in the engines/ folder and make sure it's executable.

3. Install dependencies:

pip install -r requirements.txt

from eve_chess_ai import EveChessAI

ai = EveChessAI(level='1500')  # Options: '800', '1500', '2500'
ai.start_game()

move = ai.get_best_move(fen="rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1")
print(f"Eve plays: {move}")

• Expose a simple API or method calls for Eve to retrieve moves in real-time during her streams.
• Use with a board visualizer or online chess platform interface.

You can configure:

• Elo strength: Alters depth and evaluation parameters.
• Blunder chance: Introduces deliberate mistakes.
• Move randomness: Slight variability to simulate non-deterministic play.
• All settings are managed via a config.yaml file or passed at runtime.

Copy
Edit
eve-chess-ai/
├── engines/              # Stockfish binaries
├── eve_chess_ai/         # Main Python package
│   ├── engine_interface.py
│   ├── logic.py
│   └── ...
├── tests/                # Unit tests
├── config.yaml           # AI behavior settings
├── requirements.txt
└── README.md

• Python 3.8+
• Stockfish 17+
• Unit tests can be run with:

pytest

Apache Commons 2.0 License. See LICENSE for more details.

This chess module is part of Eve, a modular AI VTuber designed to entertain, engage, and play games with audiences on Twitch and YouTube.

Pull requests, feedback, and feature requests are welcome (I DID NOT MAKE THEY WORK YET SO PLEASE HOLD ON BEFORE YOU DO THAT)!