Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
September 13, 2020 10:17
October 12, 2019 18:50
November 28, 2023 18:22
November 12, 2023 21:57
January 31, 2022 14:36
November 12, 2023 21:57
November 25, 2021 23:22
September 12, 2019 13:28
September 10, 2022 21:01
February 3, 2022 15:47


Build Status

Proof Checking of Natural Mathematical Documents, with optional support for Isabelle Prover IDE (Isabelle/PIDE – Isabelle/jEdit).

NOTE: The subsequent explanations are for development of the tool, not for end-users!

Isabelle/Naproche Prover IDE


Ensure that curl, git, and hg (Mercurial) are installed:

  • Linux: e.g. sudo apt install curl git mercurial

  • macOS: e.g. brew install mercurial or download from

  • Windows: use Cygwin64 with packages curl, git, and mercurial (via Cygwin setup-x86_64.exe)

Repository management

Commands below assume the same current directory: repository clones isabelle_naproche and naproche are put side-by-side.

  • initial clone:

    hg clone isabelle_naproche
    git clone naproche
    isabelle_naproche/Admin/init -I Isabelle_Naproche -V ./naproche/Isabelle
    isabelle_naproche/bin/isabelle components -u ./naproche
  • later updates:

    git --git-dir="./naproche/.git" pull
    isabelle_naproche/Admin/init -V ./naproche/Isabelle


  • Isabelle executable: there is no need to have isabelle_naproche/bin/isabelle in the PATH, but it is convenient to put it into a standard place once, e.g.:

    isabelle_naproche/bin/isabelle install "$HOME/bin"
  • Build and test:

    • Shutdown Isabelle/jEdit before building Isabelle/Naproche as follows:

      isabelle naproche_build
    • Run some tests as follows (make sure that your current directory is the root of the Naproche repository):

      isabelle naproche_build && isabelle naproche_test -j2
      isabelle naproche_test -o naproche_server_debugging
    • Package the Isabelle/Naproche component as follows:

      isabelle naproche_build && isabelle naproche_component -P

      The result is for the current repository version, and the underlying HW + OS platform. The following reference platforms (x86_64) are used for Isabelle2022:

      • Ubuntu Linux 16.04 LTS
      • macOS 10.14 Mojave
      • Windows 10
  • Isabelle Prover IDE

    • Open ForTheL examples in Isabelle/jEdit, e.g.

      isabelle jedit examples/cantor.ftl
    • Open Isabelle development environment with ForTheL examples, e.g.

      isabelle jedit -l Pure Isabelle/Test.thy

Low-level command-line tool (without Isabelle)


  • Supported OS platforms: Linux, macOS, Windows (e.g. with Cygwin terminal)

  • The Haskell Tool Stack:

  • Install the E Theorem Prover (supported versions: 2.0 to 2.5) and set the environment variable NAPROCHE_EPROVER to its executable path.

    Note: the E prover executable bundled with Isabelle can be located like this:

    isabelle getenv -b NAPROCHE_EPROVER
  • Optional (for development): Haskell IDE within VSCode:

Build and test

cd .../naproche  #repository

stack clean

stack build

stack test

Manual checking of proof files

stack exec Naproche-SAD -- OPTIONS FILE

It may be necessary to allow the E Prover more time by appending -t SECONDS


You can use the tool Haddock to automatically generate documentation of Naproche's source code. Just run the following command:

stack haddock

To access this documentation via a local Hoogle server, proceed the following steps:

  1. Generate a local Hoogle database.

    stack hoogle -- generate --local
  2. Start a local Hoogle server.

    stack hoogle -- server --local --port=8080

Now you can access the documentation with your favourite web browser at http://localhost:8080.

If you are developing Naproche and want to add Haddock annotations to the source files, have a look at this guide:


This program is based on the System for Automated Deduction (SAD) by Andrei Paskevich, see You can find more resources in our