Skip to content

facebook/pyre-check

Folders and files

NameName
Last commit message
Last commit date
Mar 12, 2025
Mar 27, 2025
Mar 12, 2025
Apr 1, 2025
Apr 1, 2025
Nov 22, 2024
Aug 4, 2021
Mar 18, 2025
Apr 1, 2025
Jan 31, 2025
Mar 26, 2025
Jan 22, 2025
Apr 1, 2024
Sep 19, 2023
Nov 2, 2023
Jan 6, 2025
Dec 19, 2024
Jan 15, 2025
Mar 28, 2024
Aug 4, 2021
Jul 13, 2023
Aug 7, 2020
Jan 4, 2022
Jan 7, 2025
Dec 30, 2019
Jul 18, 2020
Jul 30, 2020
Aug 16, 2018
Mar 4, 2025
May 17, 2024
Jan 15, 2025

Repository files navigation

tests License: MIT Gitter

Pyre is a performant type checker for Python compliant with PEP 484. Pyre can analyze codebases with millions of lines of code incrementally – providing instantaneous feedback to developers as they write code. You can try it out on examples in the Pyre Playground.

Pyre ships with Pysa, a security focused static analysis tool we've built on top of Pyre that reasons about data flows in Python applications. Please refer to our documentation to get started with our security analysis.

Pysa is also available on the GitHub Marketplace as a Github Action

Requirements

To get started, you need Python 3.8 or later and watchman working on your system. On MacOS you can get everything with homebrew:

$ brew install python3 watchman

On Ubuntu, Mint, or Debian; use apt-get and homebrew:

$ sudo apt-get install python3 python3-pip python3-venv
$ brew install watchman

We tested Pyre on Ubuntu 18.04.5 LTS, CentOS 7, as well as OSX 10.11 and later.

Setting up a Project

We start by creating an empty project directory and setting up a virtual environment:

$ mkdir my_project && cd my_project
$ python3 -m venv ~/.venvs/venv
$ source ~/.venvs/venv/bin/activate
(venv) $ pip install pyre-check

Next, we teach Pyre about our new project:

(venv) $ pyre init

This command will set up a configuration for Pyre (.pyre_configuration) as well as watchman (.watchmanconfig) in your project's directory. Accept the defaults for now – you can change them later if necessary.

Running Pyre

We are now ready to run Pyre:

(venv) $ echo "i: int = 'string'" > test.py
(venv) $ pyre
 ƛ Found 1 type error!
test.py:1:0 Incompatible variable type [9]: i is declared to have type `int` but is used as type `str`.

This first invocation will start a daemon listening for filesystem changes – type checking your project incrementally as you make edits to the code. You will notice that subsequent invocations of pyre will be faster than the first one.

For more detailed documentation, see https://pyre-check.org.

Join the Pyre community

See CONTRIBUTING.md for how to help out.

License

Pyre is licensed under the MIT license.