# About Repertoire Generator

Master your chess openings with our comprehensive guide

## What is Repertoire Generator?

Repertoire Generator is a free online tool that helps chess players build, study, and practice their opening repertoires.

Using a database from Lichess games (2000+ rated players, excluding bullet), the tool selects best-performing moves based on real game statistics.

## Building Your Repertoire

1. Start Building Click the "Start Building Repertoire" button on the main page to begin.
2. Set Your Starting Position Make moves on the board to reach the position you want to study. For example, you want to learn Scandinavian as black, play `1.e4 d5`. Click "Confirm Position" when ready.
3. Choose Your Color Select whether you're playing as White or Black in this position. In our case we want to learn Scandinavian defense as black, so we choose Black.
4. Select Analysis Mode Choose the depth of analysis that fits your needs:
   - Light: covers ~70% of lines found in the database
   - Deep: covers ~85% of lines, providing a larger repertoire
   - Ultradeep: covers ~95% of lines
5. Set Temperature Choose how adventurous your repertoire should be:
   - Solid: Focuses on popular moves with good win rates
   - Balanced: Mix of popularity and win rate
   - Risky: Focuses on win rate, may include rare moves
6. Generate Click "Generate" and wait a few seconds. Your repertoire will be ready to save, practice, or export!

Quick Start: `1.e4 d5` → Black → Light Mode → Balanced → Generate

## Usage Example

#### Learning the French defense as white

Goal: Build a repertoire for White against `1.e4 e6`

Steps:

1. Click "Start Building Repertoire"
2. Play `1.e4 e6` on the board
3. Click "Confirm Position"
4. Select "White"
5. Choose Light for quick coverage
6. Select Balanced temperature for balanced repertoire
7. Click "Generate"

Result: A complete repertoire covering the most effective responses to the French defense, ready to practice and memorize.

## Managing Repertoires

### Accessing Saved Repertoires

Click the menu icon (☰) in the top-left corner to open the sidebar. Your repertoires are organized by color (White/Black).

### Repertoire Actions

- Train: Click the training icon to practice with spaced repetition
- Download: Click the download icon to export as PGN
- ✕ Delete: Click the trash icon to remove

Sign in with Google or Lichess to sync your repertoires across all your devices!

## Training Mode

Training mode helps you memorize your repertoire using spaced repetition.

### How Training Works:

- The system plays the opponent's moves
- You respond with your repertoire moves
- Get instant feedback on correct/incorrect moves
- Positions you struggle with appear more frequently

## Importing PGN Files

You can import any PGN files to train them.

### Steps to Import:

1. Open Import Dialog Click "Import PGN" in the sidebar
2. Enter Details Provide a name for your repertoire and select the color
3. Add PGN Content Either upload a .pgn file or paste PGN text directly
4. Import Click "Import" to add it to your collection

## Technical Details

The move selection algorithm uses a 4GB database built from Lichess games with the following criteria:

- Both players rated 2000+
- Rated games only
- Played in the last 26 months
- Time controls: Blitz, Rapid, or Classical

The database stores every position (FEN) as a key, with move statistics as values. The algorithm selects moves based on frequency, win rates, and your chosen temperature setting.