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
July 17, 2022 01:27
July 18, 2022 10:53
July 25, 2022 14:19
October 13, 2022 15:53
February 10, 2022 08:37
September 16, 2022 09:18
September 24, 2022 16:11

Liquid Tensor Experiment

Gitpod Ready-to-Code

For the eponymous blogpost by Peter Scholze which started it all: see

The main aim of this community-owned repository is to digitise some mathematical definitions, theorem statements and theorem proofs. Digitisation, or formalisation, is a process where the source material, typically a mathematical textbook or a pdf file or website or video, is transformed into definitions in a target system consisting of a computer implementation of a logical theory (such as set theory or type theory).

The source

The main "source" definitions, theorems and proofs in this repository are all taken from Scholze's Bonn lecture notes Analytic.pdf explaining some of his work with Clausen on the theory of solid and liquid modules, and on their development of a new approach to certain proofs in complex analytic geometry.

The target

The formal system which we are using as a target system is Lean's dependent type theory. Lean is a project being developed at Microsoft Research by Leonardo de Moura and his team. Our formalisation could not have even started without a major classical mathematical library backing it up, and so we chose Lean 3 as the engine behind the project. Although Lean 4's type theory is the same as Lean 3's type theory, it currently lacks the mathematical infrastructure needed for this project.

Brief overview of the project

The challenge in the blog post is to formalise its Theorem 1.1, a variant of Analytic 9.1 (i.e. Theorem 9.1 of Analytic.pdf) in Lean.

When the project started, it was immediately noticed that there was a "sub-boss" in the form of Analytic 9.4, a far more technical theorem involving a completely different class of objects and which Scholze was claiming was a sufficiently powerful stepping stone. The project then split into two sub-projects: "Prove Analytic 9.4" and "Prove that Analytic 9.4 implies Theorem 1.1"

An important intermediate achievement was the completion of a blueprint for the proof of 9.4 and the related 9.5. The blueprint was a guide which was comprehensible to mathematicians who had no Lean training, whilst also being a visual guide to where progress was needed during the formalisation process.

The preliminary announcement of a proof of Theorem 9.4 was made on 28th May 2021, by Johan Commelin and his team from the Lean prover community. The second half of the project was completed on 14th July 2022. Together, the two components give a formal verification of Theorem 1.1 of the blogpost.

The formal statement of Analytic 9.4

The statement can be found in src/liquid.lean

theorem first_target :
  βˆ€ m : β„•, βˆƒ (k K : ℝβ‰₯0) [fact (1 ≀ k)] (cβ‚€ : ℝβ‰₯0),
  βˆ€ (S : Type) [fintype S] (V : SemiNormedGroup.{0}) [normed_with_aut r V],
    ​(( ΞΊ r V r').obj (op $ of r' (Lbar r' S))).is_weak_bounded_exact k K m cβ‚€ := _

See src/liquid.lean for details on how to read this statement.

The formal statement of Theorem 1.1

The statement can be found in src/challenge.lean

variables (p' p : ℝβ‰₯0) [fact (0 < p')] [fact (p' < p)] [fact (p ≀ 1)]

theorem liquid_tensor_experiment (S : Profinite.{0}) (V : pBanach.{0} p) :
  βˆ€ i > 0, Ext i (β„³_{p'} S) V β‰… 0 :=

How to browse this repository


Below we explain how to engage with the Lean code directly. We also provide a blueprint including two dependency graphs of the main ingredients in the repository. All material in the blueprint is cross-referenced with the Lean formalization using hyperlinks.

Getting the project

At the moment, we support two ways of browsing this repository: Either via Gitpod or by using a Lean development environment.

Crucially, both methods will allow you to introspect Lean's "Goal state" during proofs, and easily jump to definitions or otherwise follow paths through the code.

Gitpod provides an online Lean environment, but requires a GitHub account and might have weaker performance than a local installation. To use it, simply click the Gitpod button at the top of this Readme file.

To install a Lean development environment on your computer please use the installation instructions to install Lean and a supporting toolchain. After that, download and open a copy of the repository by executing the following command in a terminal:

leanproject get lean-liquid
code lean-liquid

For detailed instructions on how to work with Lean projects, see this. The script scripts/ in the folder lean-liquid will download the olean files created by our continuous integration. This will save you some time by not havig to do leanproject build.

Reading the project

With the project opened in VScode, you are all set to start exploring the code. There are two pieces of functionality that help a lot when browsing through Lean code:

  • "Go to definition": If you right-click on a name of a definition or lemma (such as Lbar, or Tinv_continuous), then you can choose "Go to definition" from the menu, and you will be taken to the relevant location in the source files. This also works by Ctrl-clicking on the name.
  • "Goal view": in the event that you would like to read a proof, you can step through the proof line-by-line, and see the internals of Lean's "brain" in the Goal window. If the Goal window is not open, you can open it by clicking on one of the icons in the top right hand corner.

Important files in the project

  • All the Lean code (the juicy stuff) is contained in the directory src/.
  • The file src/challenge.lean contains the statement of the main theorem.
  • The file src/liquid.lean contains the statement of the first target (the first half of the project).
  • The directory src/examples/ contains Lean files that explain the main ingredients in the statement of the main theorem. These files should form convincing evidence that we did not make a mistake in formalizing the necessary definitions.
  • The directory src/for_mathlib/ contains preliminary material that is gradually being moved to mathlib, the main library of mathematics for Lean.

Brief note on type theory

Lean is based on type theory, which means that some things work slightly differently from set theory. We highlight two syntactical differences.

  • Firstly, the element-of relation (∈) plays no fundamental role. Instead, there is a typing judgment (:).

    This means that we write x : X to say that "x is a term of type X" instead of "x is an element of the set X". Conveniently, we can write f : X β†’ Y to mean "f has type X β†’ Y", in other words "f is a function from X to Y".

  • Secondly, type theorists do not use the mapsto symbol (↦), but instead use lambda-notation. This means that we can define the square function on the integers via Ξ» x, x^2, which translates to x ↦ x^2 in set-theoretic notation. For more information about Ξ», see the Wikipedia page on lambda calculus.

For a more extensive discussion of type theory, see the dedicated page on the perfectoid project website.

Source reference

[Analytic] :


πŸ’§ Liquid Tensor Experiment






No releases published


No packages published