Skip to main content

CLI + library to convert chess video to PGN

Project description

KnightVision ♟️

KnightVision is a computer vision tool that converts real-world chess games (recorded from video) into PGN (Portable Game Notation) in real time. It’s designed to showcase applied machine learning and computer vision, with a CLI interface for developers and chess enthusiasts.


Features

  • Detects chessboards and pieces from video input
  • Tracks game state and outputs valid PGN
  • Supports ONNX models for fast inference
  • Simple CLI powered by Typer
  • Installable via pip

Quick start

  1. Install
pip install knightvision
  1. One-time: download models (from the latest GitHub release)
knightvision models download all
  1. See where models are resolved from
4) knightvision models locate
  1. Run on a video and show
5) knightvision run --video /path/to/game.mp4 --out /path/to/out.pgn --show

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

knightvision-0.1.0.tar.gz (3.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

knightvision-0.1.0-py3-none-any.whl (25.6 kB view details)

Uploaded Python 3

File details

Details for the file knightvision-0.1.0.tar.gz.

File metadata

  • Download URL: knightvision-0.1.0.tar.gz
  • Upload date:
  • Size: 3.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for knightvision-0.1.0.tar.gz
Algorithm Hash digest
SHA256 df7f20b0b7d94a013dea3f3d52b3b53c11a40827e200a167b6b2eb84e6d53b83
MD5 1a172cfa727bee57b4ae861b9e220350
BLAKE2b-256 c388b2189548d73d435c0b3b728f2ef0dc2f1e40116cd12a50d2af49d0f000f1

See more details on using hashes here.

File details

Details for the file knightvision-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: knightvision-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 25.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for knightvision-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 209c348c963c0ebd1e0985a3a4a818f155f69a13868cf776159acad6c049b76c
MD5 0801b9ce7ec32a78de584571ac5d9f84
BLAKE2b-256 03450003a1295dfcdafa0b2b2e686fa6ffdeb455fb11516379595480c1a4f88d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page