README.md

clichessdrill

practice chess drills in a command line interface

Installation

from PyPI:

pip install clichessdrill

or from source:

poetry install

Play

To run and play one round:

clichessdrill

and then follow the menu options.

Custom drill training plans

The user has the option to use their own custom training plan. The layout of the drill plan is a representation of the decision tree. As an example:

{
  "name": "my drill plan",
  "play": {
    "white": {
      "c4": {
        "e5": {
          "e4": {
            "Nf6": {
              "Nc3": {}
            },
            "c5": {
              "d3": {}
            }
          }
        },
        "e6": {
          "Nc3": {}
          }
        },
        "Nf6": {
          "Nc3": {}
          }
        },
        "b6": {
          "d4": {}
        }
      }
    },
    "black": {
      "e4": {
        "c6": {}
      },
      "d4": {
        "d5": {
          "Bf4": {
            "e6": {
              "Nf3": {
                "Nf6": {}
              }
            }
          }
        }
      }
    }
  }
}

The subsections for the respective game color represent the decision branches according to which the user should respond while playing either of the sides. The decision trees can be arbitrarily deep and leaves should terminate with empty brackets {}

Example Game Play