Skip to content


Repository files navigation


Documentation Status Build Status Coverage Status

lantern is a cryptanalysis library to assist with the identification and breaking of classical ciphers. The library provides general purpose analysis tools, as well as premade modules to break well known ciphers.

from lantern.modules import shift
from lantern import fitness

ciphertext = "iodj{EuxwhIrufhLvEhvwIrufh}"

decryptions = shift.crack(ciphertext, fitness.english.quadgrams)

In short, lantern can be used to:

  • Identify ciphers from ciphertext
  • Automatically crack well known ciphers
  • Analyze ciphertext to assist in the breaking of custom crypto systems


pip3 install -U lantern


Full documentation available at


Python 3.7 required.

lantern has no external dependencies outside of the standard library.


As a library, lanterns functionality can be used in REPL or pre-written scripts. The library aims to be highly modular and generalised, providing the user with the ability to extend / modify / combine functions with others to solve particular problems.

Example programs



  1. Setup a virtual environment.
virtualenv -p python3.7 venv
source ./venv/bin/activate
  1. Install development requirements.
pip3 install -Ur dev_requirements.txt
  1. Use py.test to run tests using your current working environment.

  2. Use tox to build a new environment for each python version and run all tests.


Document is built using sphinx and napoleon-sphinx.

  1. Install documentation requirements.
pip3 install -Ur docs/requirements.txt
  1. Build the HTML from inside /docs, output in build/html.
make html