Skip to content

A chess analysis tool designed to help people improve their skills.

Notifications You must be signed in to change notification settings

Daamin909/ChessBro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ChessBro™ License Version

ChessBro™ is a chess analysis tool designed to help players improve their skills by evaluating and grading each move they make during a game. The application provides instant feedback, categorizing moves into various levels such as Best, Inaccurate, and Blunder This detailed analysis allows players to learn from their mistakes and improve their strategy in real-time.

Table of Contents

Features

  • Move Analysis: Evaluates your moves for accuracy, precision, and effectiveness.
  • Opening Name: Understand current opening and it's variations.
  • Instant Feedback: Get immediate analysis after every move to refine your skills.

Tech Stack

Frontend

  • React
  • HTML5
  • CSS3
  • JavaScript
  • JSX

Backend

  • Python
  • Stockfish

Tools

  • Node.js
  • Vite

Installation

Backend Setup (Python)

  1. Navigate to the backend folder:
cd backend
  1. Install the required Python dependencies:
pip install -r requirements.txt
  1. Start the Python server:
python server.py

Frontend Setup (Node.js)

  1. Go back to the root directory and navigate to the chessbro folder:
cd ../chessbro
  1. Install the required npm dependencies:
npm install
  1. Start the frontend application:
npm run dev

Alternatively, you can access the live version online at ChessBro™ Live.

Usage

Navigate to localhost:5317 after starting both servers to begin using ChessBro™. For a live demo, visit ChessBro™ Live.

Contributing

ChessBro™ is an open-source project, and contributions are welcome! If you want to contribute, please follow these guidelines:

  1. Fork the repository: Create your own copy of the repository on GitHub.
  2. Clone the repository: Download your fork locally.
      git clone https://github.com/your-username/chessbro.git
  3. Create a new branch: Make sure your branch is descriptive of the changes you're making.
    git checkout -b feature-or-bug-fix
  4. Make changes: Implement your improvements or bug fixes. Commit your changes: Make clear, concise commits describing the changes.
    git commit -m "Fix issue with move grading"
  5. Push your changes: Push your branch to your forked repository.
    git push origin feature-or-bug-fix

Create a pull request: Submit a pull request to the main repository. If you're unsure about anything or need guidance, feel free to open an issue, and I will assist you. All contributions will be reviewed and merged if they align with the project’s goals.

Acknowledgements

Stockfish: ChessBro™ uses the Stockfish chess engine for move analysis and evaluation. Stockfish is an open-source chess engine, and its performance is widely recognized as one of the best in the world. Thank you to the Stockfish team for their incredible work!

A huge thank you to all open-source contributors whose work makes this project possible!

About Me

I'm Daamin Ashai, a 13-year-old developer from Jammu & Kashmir, India. I'm passionate about coding and continuously learning new tech skills. I enjoy working on projects like ChessBro™ to combine my interests in programming and chess.

ChessBro™ Project

ChessBro™ is one of my many personal projects where I aim to merge my love for chess and coding. This project uses React, Python, and Stockfish to help players analyze and improve their chess skills. I hope this project serves as a useful tool for chess enthusiasts, helping them sharpen their moves and become better players.

Thank you for visiting and supporting my work!

Feel free to connect with me via my website Daamin Ashai or reach out through my social handles for any queries or collaboration opportunities!