Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Pyrefly: A fast type checker and language server for Python with powerful IDE features

pyrefly PyPI VS Code Open VSX Discord License: MIT

Pyrefly is a type checker and language server for Python, which provides lightning-fast type checking along with IDE features such as code navigation, semantic highlighting, and code completion. It is available as a command-line tool and an extension for popular IDEs and editors such as VSCode, Neovim, Zed, and more.

See the Pyrefly website for full documentation and how to add Pyrefly to your editor of choice.

Pyrefly's current development status is stable.

Key Features

  • Fast. Pyrefly checks over 1.85 million lines of code per second, type checking projects like PyTorch 15x faster than Mypy and Pyright. In the IDE, rechecks typically complete in under 10 milliseconds after saving a file.
  • Production-proven at scale. Pyrefly is the default type checker for Instagram's 20-million-line Python codebase at Meta, and has been adopted by large open source projects including PyTorch and JAX.
  • Full-featured language server. Code navigation, autocomplete, hover information, inlay hints, semantic highlighting, and more, with consistent results across the CLI and your editor of choice.
  • Understands real-world Python. Built-in support for frameworks and tools like Pydantic, Django, and pytest, with model validation, field types, fixture navigation, and autocomplete that work out of the box.
  • Adoption-ready. Migrate from Mypy or Pyright with pyrefly init, silence existing errors with pyrefly suppress, and generate type annotations with pyrefly infer. Start with one file and expand at your own pace.

Getting Started

Version Policy

Pyrefly releases new minor versions (1.x.0) monthly and patch versions in between as-needed for critical fixes. Pyrefly does not follow strict semantic versioning: minor versions contain more significant changes than patch versions, but any version may introduce new type errors and other breaking changes. The pyrefly suppress command can be used to easily silence errors when upgrading to a new version.

Getting Involved

If you have questions or would like to report a bug, please create an issue.

See our contributing guide and architecture overview for information on how to contribute to Pyrefly.

Join our Discord to chat about Pyrefly and types. This is also where we hold biweekly office hours.

Release files for pyrefly 1.4.0.dev1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyrefly 1.4.0.dev1
File Size Uploaded
pyrefly-1.4.0.dev1.tar.gz 6.8 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for pyrefly 1.4.0.dev1
File
pyrefly-1.4.0.dev1-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details
pyrefly-1.4.0.dev1-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
pyrefly-1.4.0.dev1-py3-none-win32.whl Python 3 none Windows x86-32 Details
pyrefly-1.4.0.dev1-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details
pyrefly-1.4.0.dev1-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details
pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details
pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details
pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
pyrefly-1.4.0.dev1-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
pyrefly-1.4.0.dev1-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details

Total release size: 174.4 MB

Release files / pyrefly-1.4.0.dev1.tar.gz

Download URL pyrefly-1.4.0.dev1.tar.gz
Size 6.8 MB
Tags Source
SHA-256 checksum
How to use checksums
002bd95739c0b7a14aeb08f4a0e0635f411e87f57d1f6f81a829295068cbbc82
BLAKE2b-256 checksum
How to use checksums
98d90f97458416923b1b04ad413f7176d5d18a49484d67cff4452bb3c4eb05f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-win_arm64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-win_arm64.whl
Size 14.5 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
8dea1cc70b2e86fb8c37a522c982cda1ad61aa67c6491b44aa17480c0d3e6328
BLAKE2b-256 checksum
How to use checksums
0f8a5b906e21166ff1a644873e468102a2378932bbe852f5d6704d1ccf911d41
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-win_amd64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-win_amd64.whl
Size 15.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
8f02aedac995770d2ee8d6f8b9bb7a523cb3bec5b37e989f94007013fe9a77a6
BLAKE2b-256 checksum
How to use checksums
c8ae18d510586a2076066a6067ad9dd8cef2bbfe5077ef25aca9d8b722f30107
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-win32.whl

Download URL pyrefly-1.4.0.dev1-py3-none-win32.whl
Size 14.4 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
0535a5acfd2eaa142a5c53457389345b5c2c89e7053c1ba1f2e93237d2cef20a
BLAKE2b-256 checksum
How to use checksums
31a51090be74a81a408ed8bd7de947e44fdc24cdb9064b5c6c64e76c3452d4d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-musllinux_1_2_x86_64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-musllinux_1_2_x86_64.whl
Size 15.6 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
1ddc13bd7a0b53909dbb0f1cf683772cd7320bd6c32e8cb0653bc43173508a3b
BLAKE2b-256 checksum
How to use checksums
eb631865baf3defcf4d026571fff41c6662cea5819497a8f2eaedf6f99042f69
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-musllinux_1_2_aarch64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-musllinux_1_2_aarch64.whl
Size 15.0 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
804f8d89279ecbbd656aab1b32706943b8cdaebe42ac56eda6743b2860b47777
BLAKE2b-256 checksum
How to use checksums
8da3a58bff0f322255c374bdd466ddcbf02bed825ceeb04b74d209871267b92e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 15.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
109f697958624c5a2a0e2d8e96446430c7669e812b5fd2d53606080a9bfa5e8b
BLAKE2b-256 checksum
How to use checksums
035ba128b0e863a0efa90d6ac3a9b46def2720f2d9bdc20abc5237586c62aa11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Size 16.3 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
5da07cb92206b471163b4f77ff1c5cf3ba5986e4d8812ea8bdd7b55513968128
BLAKE2b-256 checksum
How to use checksums
99ce4427f496bbdafa9c73bf08436acbf05239d28b8ff7013b2f75bcd8f86c07
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size 16.3 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
24def0fc35f0d021be9b55f6215797770308b10ba3165955c31bcd63a880bcc7
BLAKE2b-256 checksum
How to use checksums
6e49e3fa039eb30a0eacc88f5af0864b8b39f85e74166287840ac77a542b067f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 15.0 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
981e50db5d114f6e0f836de83b59137a842d077163e5a992051a92d59e82f8c5
BLAKE2b-256 checksum
How to use checksums
949bfe6f1a945572ac090e7f4b6273ad5a5ba0bacc3425ba9aa5b245f2ce43ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-macosx_11_0_arm64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-macosx_11_0_arm64.whl
Size 14.6 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
08aae1ae45ba59395042b4eefb381cf6f5fb6881dd496ff82f0f050784cd189d
BLAKE2b-256 checksum
How to use checksums
6e2631ccb856b9be7504012abfd91db13632fc109f8de4780cb5494c4bececfa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / pyrefly-1.4.0.dev1-py3-none-macosx_10_12_x86_64.whl

Download URL pyrefly-1.4.0.dev1-py3-none-macosx_10_12_x86_64.whl
Size 15.2 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
ad4e2c61b642569ad44526d561b1804a8e2490b97d2a03f396dfd5bce8814f20
BLAKE2b-256 checksum
How to use checksums
0ea5a1a9813e7e7f58c4e6024fca35d636602c91fd67f12adeb9dafb0f1b2eac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.4.0.dev1 This release

12 release files

1.3.1

12 release files

1.3.0

12 release files

1.2.1

12 release files

1.1.1

12 release files

1.1.0

12 release files

1.0.0

10 release files

0.59.0

9 release files

0.58.0

9 release files

0.57.1

9 release files

0.57.0

9 release files

0.56.0

9 release files

0.54.0

9 release files

0.53.0

9 release files

0.50.1

9 release files

0.50.0

9 release files

0.49.0

9 release files

0.48.2

9 release files

0.48.1

9 release files

0.48.0

9 release files

0.46.3

9 release files

0.46.2

9 release files

0.46.1

9 release files

0.46.0

9 release files

0.45.2

9 release files

0.43.1

9 release files

0.43.0

9 release files

0.42.3

9 release files

0.42.2

9 release files

0.42.1

9 release files

0.42.0

9 release files

0.41.3

9 release files

0.41.2

9 release files

0.41.1

9 release files

0.41.0

9 release files

0.39.4

9 release files

0.39.3

9 release files

0.39.2

9 release files

0.39.1

9 release files

0.39.0

9 release files

0.38.2

9 release files

0.38.1

9 release files

0.38.0

9 release files

0.37.0

9 release files

0.35.0

9 release files

0.34.0

9 release files

0.33.1

9 release files

0.33.0

9 release files

0.30.0

9 release files

0.29.2

9 release files

0.29.1

9 release files

0.29.0

9 release files

0.28.1

9 release files

0.28.0

9 release files

0.26.1

9 release files

0.26.0

9 release files

0.25.1

9 release files

0.25.0

9 release files

0.24.2

9 release files

0.24.1

9 release files

0.24.0

9 release files

0.22.0

9 release files

0.21.0

9 release files

0.20.2

9 release files

0.20.1

9 release files

0.20.0

9 release files

0.19.2

9 release files

0.19.1

9 release files

0.17.1

9 release files

0.17.0

9 release files

0.16.3

9 release files

0.16.2

9 release files

0.16.1

8 release files

0.16.0

8 release files

0.15.2

8 release files

0.15.1

8 release files

0.15.0

8 release files

0.14.1

8 release files

0.13.0

8 release files

0.12.1

8 release files

0.12.0

8 release files

0.11.1

8 release files

0.11.0

8 release files

0.10.2

8 release files

0.9.0

8 release files

0.8.0

8 release files

0.7.0

8 release files

0.6.0

8 release files

0.5.0

8 release files

0.4.0

8 release files

0.3.0

8 release files

0.2.0

8 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page