ChessNet — local chess server with bot

Welcome to ChessNet — a small chess server where you can run on your own machine or inside a local network.

You can play either against another human on a browser tab or against a bot with two difficulty levels.

---

Requirements

• Python 3.10+
• pip installed
• (optional, but recommended) virtual environment

---

Installation

# clone the project, then
cd Chess

# create and activate virtual environment (Windows)
python -m venv .venv
.venv\Scripts\activate

# install dependencies
pip install -r requirements.txt

---

Running the server

In the project root (/Chess) run:

python -m uvicorn server.main:app --host 0.0.0.0 --port 8000

You should see something like:

Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

---

Opening the game in a browser

On your computer just open:

http://localhost:8000 or http://127.0.0.1:8000

From another device in your local network find your PC's IP address, open in browser:

http://YOUR-IP-ADDRESS:8000

---

Enjoy the game! :)