metadata

license: mit
datasets:
  - Xmaster6y/stockfish-debug
name: Xmaster6y/gpt2-stockfish-debug
results:
  - task: train
    metrics:
      - name: train-loss
        type: loss
        value: 0.151
        verified: false
      - name: eval-loss
        type: loss
        value: 0.138
        verified: false
widget:
  - text: |-
      FEN: rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1
      MOVE:
    example_title: Init board
  - text: |-
      FEN: r2qr1k1/1p3ppp/2n1bb2/p2p4/P2N4/1B1P2B1/1PP2PPP/R2QR1K1 b - - 0 16
      MOVE:
    example_title: Board with legal completion
  - text: |-
      FEN: 6k1/1p3ppp/2b2b2/p2p4/P2Q4/1B1P2B1/1PP2PPP/4q1K1 w - - 2 24
      MOVE:
    example_title: Board with illegal completion

Model Card for gpt2-stockfish-debug

Training Details

The model was trained during 1 epoch on the Xmaster6y/stockfish-debug dataset (no hyperparameter tuning done). The samples are:

{"prompt":"FEN: {fen}\nMOVE:", "completion": " {move}"}

Two possible simple extensions:

Expand the FEN string: r2qk3/... -> r11qk111/... or equivalent
Condition with the result (ELO not available in the dataset):

{"prompt":"RES: {res}\nFEN: {fen}\nMOVE:", "completion": " {move}"}

Use the Model

The following code requires python-chess (in addition to transformers) which you can install using pip install python-chess.

import chess
from transformers import AutoModelForCausalLM, AutoTokenizer


def next_move(model, tokenizer, fen):
    input_ids = tokenizer(f"FEN: {fen}\nMOVE:", return_tensors="pt")
    input_ids = {k: v.to(model.device) for k, v in input_ids.items()}
    out = model.generate(
        **input_ids,
        max_new_tokens=10,
        pad_token_id=tokenizer.eos_token_id,
        do_sample=True,
        temperature=0.1,
    )
    out_str = tokenizer.batch_decode(out)[0]
    return out_str.split("MOVE:")[-1].replace("<|endoftext|>", "").strip()


board = chess.Board()
model = AutoModelForCausalLM.from_pretrained("Xmaster6y/gpt2-stockfish-debug")
tokenizer = AutoTokenizer.from_pretrained("Xmaster6y/gpt2-stockfish-debug")  # or "gpt2"
tokenizer.pad_token = tokenizer.eos_token
for i in range(100):
    fen = board.fen()
    move_uci = next_move(model, tokenizer, fen)
    try:
        print(move_uci)
        move = chess.Move.from_uci(move_uci)
        if move not in board.legal_moves:
            raise chess.IllegalMoveError
        board.push(move)
    except chess.IllegalMoveError:
        print(board)
        print("Illegal move", i)
        break