Skip to main content
🛡️ Verified Technical Content: Written by Serhii Hrekov. | Last reviewed & updated in Git: July 21, 2026

MyPy vs. Pyright: A Comprehensive Guide to Python Static Type Checkers

· 6 min read
Serhii Hrekov
Serhii Hrekov
Senior Software Engineer & System Architect specializing in Python, Web Systems, Cloud Infrastructure & Automation

To maintain clean and bug-free codebases in large Python projects, static type checking is essential. The two primary static type checkers in the modern Python ecosystem are MyPy (the reference implementation) and Pyright (a fast, TypeScript-based checker developed by Microsoft).

While both tools parse type hints to identify errors before runtime, they differ in their implementation languages, performance profiles, library extensibility, and strictness. This guide provides a detailed comparison of MyPy and Pyright, analyzing their architectural trade-offs, behavioral differences, and how to combine them into a single workflow.

Architectural Comparison​

FeatureMyPyPyright
Implementation LanguagePure PythonTypeScript
Runtime EnvironmentPython interpreterNode.js (or bundled in VS Code/Pylance)
PerformanceCan be slow on large monoreposNear-instantaneous check speeds
ExtensibilitySupports custom Python pluginsNo public plugin system
Reference StandardAims to strictly align with CPython PEPsPrioritizes developer experience and IDE features

Core Differences​

1. Extensibility and Plugin Support​

MyPy's greatest architectural advantage is its plugin system. Python libraries that use dynamic code generation, metaclass magic, or runtime reflection (such as SQLAlchemy, Django ORM, or Pydantic) often confuse standard static checkers.

  • MyPy: Developers can write custom Python scripts (plugins) to teach MyPy how to parse these dynamic structures, ensuring accurate type inference.
  • Pyright: Lacks a public plugin API. When working with complex frameworks like SQLAlchemy, Pyright may generate false-positive errors, requiring developers to write extensive # type: ignore comments.

2. PEP Compliance vs. Developer Experience​

  • MyPy: Serves as the reference implementation for Python typing standards. It strictly adheres to PEP specifications, sometimes flagging edge cases that other tools overlook.
  • Pyright: Designed primarily to power the Pylance language server in VS Code. It uses optimistic type inference to keep editor completions fast. This can sometimes result in false negatives, allowing code to pass that MyPy would reject.

3. Node.js Runtime Dependency​

  • MyPy: Installs directly via pip and runs using your existing Python environment, keeping CI/CD configurations simple.
  • Pyright: Being written in TypeScript, Pyright requires a Node.js runtime. This adds a second runtime dependency to otherwise pure-Python build environments.

Behavioral Differences​

The two checkers handle dynamic constructs and structural types differently:

  • Untyped Functions: When strict modes are enabled, MyPy flags calls to untyped functions as unsafe. Pyright is more lenient, inferring the type as Any to let the execution proceed.
  • Protocol and Structural Subtyping: Pyright has excellent support for structural subtyping, evaluating class compatibilities based on the methods they define rather than nominal inheritance.
  • Recursive Typing: Pyright handles recursive types (such as nested JSON dictionaries) more intuitively out of the box, whereas MyPy can require more verbose configs.

The Hybrid Dual-Tool Strategy​

For many development teams, the optimal approach is to use both tools in a hybrid model:

graph TD
    Dev[Developer Coding] -->|Real-time Errors| VSCode[VS Code + Pyright/Pylance]
    VSCode -->|Fast Autocomplete| Dev
    Dev -->|Git Commit & Push| CI[CI/CD Pipeline]
    CI -->|Authoritative PEP Check| MyPy[MyPy Run]
  1. Local Development (Pyright): Use Pyright (via the Pylance extension in VS Code) to get fast, real-time feedback, auto-completions, and navigation as you write code.
  2. CI/CD Quality Gate (MyPy): Use MyPy as the authoritative quality gate in your integration pipelines. MyPy's strict compliance and plugin support ensure that all code merges meet the project's safety requirements.

Sources​