{"id":13484358,"url":"https://github.com/leanprover-community/mathlib4","last_synced_at":"2026-04-02T11:47:16.413Z","repository":{"id":37006421,"uuid":"365697493","full_name":"leanprover-community/mathlib4","owner":"leanprover-community","description":"The math library of Lean 4","archived":false,"fork":false,"pushed_at":"2024-10-29T09:23:02.000Z","size":294024,"stargazers_count":1494,"open_issues_count":1326,"forks_count":329,"subscribers_count":39,"default_branch":"master","last_synced_at":"2024-10-29T09:23:22.035Z","etag":null,"topics":["lean4"],"latest_commit_sha":null,"homepage":"https://leanprover-community.github.io/mathlib4_docs","language":"Lean","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leanprover-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-09T07:52:01.000Z","updated_at":"2024-10-29T09:05:40.000Z","dependencies_parsed_at":"2024-11-05T10:28:13.851Z","dependency_job_id":null,"html_url":"https://github.com/leanprover-community/mathlib4","commit_stats":null,"previous_names":[],"tags_count":221,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leanprover-community%2Fmathlib4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leanprover-community%2Fmathlib4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leanprover-community%2Fmathlib4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leanprover-community%2Fmathlib4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leanprover-community","download_url":"https://codeload.github.com/leanprover-community/mathlib4/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245882250,"owners_count":20687858,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["lean4"],"created_at":"2024-07-31T17:01:22.999Z","updated_at":"2026-04-02T11:47:16.405Z","avatar_url":"https://github.com/leanprover-community.png","language":"Lean","funding_links":[],"categories":["Lean","Mathematics","Core packages"],"sub_categories":[],"readme":"# mathlib4\n\n![GitHub CI](https://github.com/leanprover-community/mathlib4/actions/workflows/build.yml/badge.svg?branch=master)\n[![Bors enabled](https://raw.githubusercontent.com/bors-ng/bors-ng.github.io/refs/heads/master/images/badge_small.svg)](https://mathlib-bors-ca18eefec4cb.herokuapp.com/repositories/16)\n[![project chat](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://leanprover.zulipchat.com)\n[![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/leanprover-community/mathlib4)\n\n[Mathlib](https://leanprover-community.github.io) is a user maintained library for the [Lean theorem prover](https://leanprover.github.io).\nIt contains both programming infrastructure and mathematics,\nas well as tactics that use the former and allow to develop the latter.\n\n## Installation\n\nYou can find detailed instructions to install Lean, mathlib, and supporting tools on [our website](https://leanprover-community.github.io/get_started.html).\nAlternatively, click on one of the buttons below to open a GitHub Codespace or a Gitpod workspace containing the project.\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/leanprover-community/mathlib4)\n\n[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/leanprover-community/mathlib4)\n\n## Using `mathlib4` as a dependency\n\nPlease refer to\n[https://github.com/leanprover-community/mathlib4/wiki/Using-mathlib4-as-a-dependency](https://github.com/leanprover-community/mathlib4/wiki/Using-mathlib4-as-a-dependency)\n\n## Experimenting\n\nGot everything installed? Why not start with the [tutorial project](https://leanprover-community.github.io/install/project.html)?\n\nFor more pointers, see [Learning Lean](https://leanprover-community.github.io/learn.html).\n\n## Documentation\n\nBesides the installation guides above and [Lean's general\ndocumentation](https://docs.lean-lang.org/lean4/doc/), the documentation\nof mathlib consists of:\n\n- [The mathlib4 docs](https://leanprover-community.github.io/mathlib4_docs/index.html): documentation [generated\n  automatically](https://github.com/leanprover/doc-gen4) from the source `.lean` files.\n- A description of [currently covered theories](https://leanprover-community.github.io/theories.html),\n  as well as an [overview](https://leanprover-community.github.io/mathlib-overview.html) for mathematicians.\n- Some [extra Lean documentation](https://leanprover-community.github.io/learn.html) not specific to mathlib (see \"Miscellaneous topics\")\n- Documentation for people who would like to [contribute to mathlib](https://leanprover-community.github.io/contribute/index.html)\n\nMuch of the discussion surrounding mathlib occurs in a [Zulip chat\nroom](https://leanprover.zulipchat.com/), and you are welcome to join, or read\nalong without signing up.  Questions from users at all levels of expertise are\nwelcome!  We also provide an [archive of the public\ndiscussions](https://leanprover-community.github.io/archive/), which is useful\nfor quick reference.\n\n## Contributing\n\nThe complete documentation for contributing to ``mathlib`` is located\n[on the community guide contribute to mathlib](https://leanprover-community.github.io/contribute/index.html)\n\nYou may want to subscribe to the `mathlib4` channel on [Zulip](https://leanprover.zulipchat.com/) to introduce yourself and your plan to the community.\nOften you can find community members willing to help you get started and advise you on the fit and\nfeasibility of your project.\n\n* To obtain precompiled `olean` files, run `lake exe cache get`. (Skipping this step means the next step will be very slow.)\n* To build `mathlib4` run `lake build`.\n* To build and run all tests, run `lake test`.\n* You can use `lake build Mathlib.Import.Path` to build a particular file, e.g. `lake build Mathlib.Algebra.Group.Defs`.\n* If you added a new file, run the following command to update `Mathlib.lean`\n\n  ```shell\n  lake exe mk_all\n  ```\n\n### Guidelines\n\nMathlib has the following guidelines and conventions that must be followed\n\n - The [style guide](https://leanprover-community.github.io/contribute/style.html)\n - A guide on the [naming convention](https://leanprover-community.github.io/contribute/naming.html)\n - The [documentation style](https://leanprover-community.github.io/contribute/doc.html)\n\n### Downloading cached build files\n\nYou can run `lake exe cache get` to download cached build files that are computed by `mathlib4`'s automated workflow.\n\nIf something goes mysteriously wrong,\nyou can try one of `lake clean` or `rm -rf .lake` before trying `lake exe cache get` again.\nIn some circumstances you might try `lake exe cache get!`\nwhich re-downloads cached build files even if they are available locally.\n\nCall `lake exe cache` to see its help menu.\n\n### Building HTML documentation\n\nThe [mathlib4_docs repository](https://github.com/leanprover-community/mathlib4_docs)\nis responsible for generating and publishing the\n[mathlib4 docs](https://leanprover-community.github.io/mathlib4_docs/index.html).\n\nThat repo can be used to build the docs locally:\n```shell\ngit clone https://github.com/leanprover-community/mathlib4_docs.git\ncd mathlib4_docs\ncp ../mathlib4/lean-toolchain .\nlake exe cache get\nlake build Mathlib:docs\n```\nThe last step may take a while (\u003e20 minutes).\nThe HTML files can then be found in `.lake/build/doc`.\n\n## Transitioning from Lean 3\n\nFor users familiar with Lean 3 who want to get up to speed in Lean 4 and migrate their existing\nLean 3 code we have:\n\n- A [survival guide](https://github.com/leanprover-community/mathlib4/wiki/Lean-4-survival-guide-for-Lean-3-users)\n  for Lean 3 users\n- [Instructions to run `mathport`](https://github.com/leanprover-community/mathport#running-on-a-project-other-than-mathlib)\n  on a project other than mathlib. `mathport` is the tool the community used to port the entirety\n  of `mathlib` from Lean 3 to Lean 4.\n\n### Dependencies\n\nIf you are a mathlib contributor and want to update dependencies, use `lake update`,\nor `lake update batteries aesop` (or similar) to update a subset of the dependencies.\nThis will update the `lake-manifest.json` file correctly.\nYou will need to make a PR after committing the changes to this file.\n\nPlease do not run `lake update -Kdoc=on` as previously advised, as the documentation related\ndependencies should only be included when CI is building documentation.\n\n## Maintainers:\n\nFor a list containing more detailed information, see https://leanprover-community.github.io/teams/maintainers.html\n\n* Anne Baanen (@Vierkantor): algebra, number theory, tactics\n* Matthew Robert Ballard (@mattrobball): algebra, algebraic geometry, category theory\n* Riccardo Brasca (@riccardobrasca): algebra, number theory, algebraic geometry, category theory\n* Kevin Buzzard (@kbuzzard): algebra, number theory, algebraic geometry, category theory\n* Mario Carneiro (@digama0): lean formalization, tactics, type theory, proof engineering\n* Bryan Gin-ge Chen (@bryangingechen): documentation, infrastructure\n* Johan Commelin (@jcommelin): algebra, number theory, category theory, algebraic geometry\n* Anatole Dedecker (@ADedecker): topology, functional analysis, calculus\n* Rémy Degenne (@RemyDegenne): probability, measure theory, analysis\n* Floris van Doorn (@fpvandoorn): measure theory, model theory, tactics\n* Frédéric Dupuis (@dupuisf): linear algebra, functional analysis\n* Sébastien Gouëzel (@sgouezel): topology, calculus, geometry, analysis, measure theory\n* Markus Himmel (@TwoFX): category theory\n* Yury G. Kudryashov (@urkud): analysis, topology, measure theory\n* Robert Y. Lewis (@robertylewis): tactics, documentation\n* Jireh Loreaux (@j-loreaux): analysis, topology, operator algebras\n* Heather Macbeth (@hrmacbeth): geometry, analysis\n* Patrick Massot (@patrickmassot): documentation, topology, geometry\n* Bhavik Mehta (@b-mehta): category theory, combinatorics\n* Kyle Miller (@kmill): combinatorics, tactics, metaprogramming\n* Kim Morrison (@kim-em): category theory, tactics\n* Oliver Nash (@ocfnash): algebra, geometry, topology\n* Filippo A. E. Nuccio (@faenuccio): algebra, functional analysis, homology, number theory\n* Joël Riou (@joelriou): category theory, homology, algebraic geometry\n* Michael Rothgang (@grunweg): differential geometry, analysis, topology, linters\n* Damiano Testa (@adomani): algebra, algebraic geometry, number theory, tactics, linters\n* Adam Topaz (@adamtopaz): algebra, category theory, algebraic geometry\n* Eric Wieser (@eric-wieser): algebra, infrastructure\n\n## Past maintainers:\n\n* Jeremy Avigad (@avigad): analysis\n* Reid Barton (@rwbarton): category theory, topology\n* Gabriel Ebner (@gebner): tactics, infrastructure, core, formal languages\n* Johannes Hölzl (@johoelzl): measure theory, topology\n* Simon Hudon (@cipher1024): tactics\n* Chris Hughes (@ChrisHughes24): algebra\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleanprover-community%2Fmathlib4","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleanprover-community%2Fmathlib4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleanprover-community%2Fmathlib4/lists"}