ChessMate - Advanced Chess Game Analysis Platform

ChessMate is a sophisticated chess analysis platform that combines the power of the Stockfish engine with modern web technologies to provide detailed game analysis and personalized feedback.

Navigation

• Features
• Prerequisites
• Installation
• Usage
• Testing
• API Documentation
• Contributing
• License
• Acknowledgments

Features

• Game Analysis: Detailed analysis of chess games using Stockfish engine
• Personalized Feedback: AI-powered feedback on your games
• Credit System: Flexible credit packages for game analysis
• Multi-Platform Support: Import games from Chess.com and Lichess
• Modern UI: Responsive design with real-time updates
• Secure Authentication: JWT-based authentication system

Prerequisites

• Python 3.8+
• Node.js 14+
• Redis Server
• Stockfish Chess Engine
• PostgreSQL (optional, SQLite by default)

Installation

1. Clone the repository:

   git clone https://github.com/ahmed5145/chessmate.git
   cd chessmate

2. Install dependencies:

   • Backend:

     cd chessmate
     python -m venv venv
     source venv/bin/activate  # or `venv\Scripts\activate` on Windows
     pip install -r requirements.txt

   • Frontend:

     cd frontend
     npm install

3. Set up environment variables:

   cp .env.example .env
   # Edit .env with your configuration:
   # - Set up email credentials
   # - Add OpenAI API key
   # - Configure Stripe keys
   # - Set Stockfish path

4. Initialize the database:

   python manage.py makemigrations
   python manage.py migrate

5. Start Redis Server:

   redis-server

6. Start Celery Worker:

   celery -A chess_mate worker -l info

7. Run development servers:

   • Backend:

     cd chess_mate
     python manage.py runserver

   • Frontend:

     cd frontend
     npm start

Usage

1. Create an account or sign in using your email and password
2. Purchase analysis credits from available packages
3. Import games from Chess.com or Lichess
4. Select games for analysis
5. View detailed analysis including:
   • Move accuracy
   • Critical moments
   • Improvement suggestions
   • Opening recommendations
   • Time management feedback

Testing

• Backend Tests:

  cd chess_mate
  python -m pytest

• Frontend Tests:

  cd frontend
  npm test

API Documentation

See API Documentation for detailed endpoint information.

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Stockfish Chess Engine
• OpenAI API
• Chess.com API
• Lichess API

---

Document last updated on January 18, 2024
Copyright © 2024 ChessMate. All rights reserved.