
Pysa
Pysa is a Python static analysis tool that uses taint analysis to identify potential security issues in source code.
What Pysa is
Pysa is a Python static analysis tool that uses taint analysis to identify potential security issues in source code. It tracks data from configured sources toward dangerous sinks, such as user-controlled request data reaching an eval call. You can define sources, sinks, features, and rules in taint.config, then annotate code with .pysa model files. Pysa includes prewritten models and rules for built-in and common Python libraries, and supports sanitizer models for data that should lose taint. Analysis covers the target repository and configured search_path directories; dependency source outside those paths is not examined. When Pysa cannot access a function's source, it assumes the return value retains taint, which can result in false positives. The quickstart installs it with pip install pyre-check in a Python virtual environment. Pyre supports the Language Server Protocol, and its VSCode extension connects to a running server. A documented workflow uses SAPP to view and filter findings, and a GitHub Action can run Pysa in CI. Pysa is MIT-licensed and free; its repository requires Python 3.9 or later and relies on type information from Pyrefly.
Good
- Tracks configured sources to dangerous sinks.
- Includes models for built-in and common libraries.
- Supports sanitizer models for parameters and returns.
- Can run in CI with a GitHub Action.
Watch out
- Does not inspect dependencies outside configured paths.
- Missing function source can lead to false positives.
- May freeze when analysis lacks enough memory.
- Default SAPP filters may trade false positives for false negatives.
Who it suits
Pysa suits Python teams looking for source-code taint analysis, including teams that want to run checks in CI. It is most relevant when the code and dependencies to analyze are available within the configured search paths.
Verdict
Pysa offers configurable taint analysis and workflows for reviewing findings locally or in CI. Its analysis scope and possible false positives are important considerations, and the Pyre repository says it was archived on June 26, 2026, with Pysa moved to its own repository.
Plans and prices
From Pysa's own pricing page, checked 8 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Free (MIT-licensed open-source software) | Free | Python static analysis; install with pip |
The facts
Each one read from Pysa's own pages, with the date it was checked.
What it does
- Analysis limitation
- Pysa analyzes code in the repository and configured search paths, but does not see dependency source code outside those paths.checked 8 Oct 2026
- Analysis scope
- Pysa analyzes code in the target repository and directories listed in the configuration search_path; it does not see dependency source code otherwise.checked 4 Oct 2026
- Built-in coverage
- Pysa includes pre-written models and rules for built-in and common Python libraries.checked 8 Oct 2026
- CI integration
- A GitHub Action can run Pysa in CI and show results in GitHub's Security code scanning UI.checked 8 Oct 2026
- Codebase scale
- The Pysa repository says it can analyze codebases with millions of lines of code.checked 8 Oct 2026
- Data flow analysis
- Pysa tracks data from sources to dangerous sinks, such as user-controlled request data reaching an eval call.checked 4 Oct 2026
- Editor integration
- Pyre supports the Language Server Protocol and provides a VSCode extension that connects to a running server.checked 4 Oct 2026
- Filtering trade-off
- The Pysa Action documentation says its default SAPP filters aim for higher-signal results and may trade false positives for false negatives.checked 8 Oct 2026
- Installation
- Pysa is currently distributed as part of the pyre-check package and can be installed with pip install pyre-check.checked 8 Oct 2026
- Known limitation
- When Pysa encounters a function whose source it cannot access, it assumes the function's return value has the same taint, which can cause false positives.checked 4 Oct 2026
- Known trade-off
- The documentation says Pysa may produce false positives when it lacks a function's source and assumes the return value retains taint.checked 8 Oct 2026
- License
- Pysa is licensed under the MIT license.checked 8 Oct 2026
- Maintenance status
- The Pyre repository says it was archived on June 26, 2026, and that Pysa moved to its own repository.checked 4 Oct 2026
- Models and rules
- Users configure sources, sinks, features, and rules in taint.config and model files with the .pysa extension.checked 8 Oct 2026
- Purpose
- Pysa is a security-focused static analysis tool for Python that tracks data flows to find security and privacy issues.checked 8 Oct 2026
- Requirements
- Pysa requires Python 3.9 or later and currently relies on type information from Pyrefly.checked 8 Oct 2026
- Resource needs
- The quickstart says Pysa may freeze during analysis on projects of similar size when the machine does not have enough memory.checked 4 Oct 2026
- Results interface
- The documented quickstart uses SAPP to ingest Pysa results and view and filter issues in a local web UI.checked 8 Oct 2026
- Results workflow
- The quickstart uses SAPP to ingest Pysa results and provides a web UI for viewing and filtering issues.checked 4 Oct 2026
- Sanitizers
- Pysa models sanitizers that remove taint from data, including annotations for sanitizing return values and parameters.checked 4 Oct 2026
- Security reporting
- The Pysa security policy asks users to report security issues through Meta's Bug Bounty program rather than public GitHub issues or pull requests.checked 8 Oct 2026
- Taint analysis
- Pysa tracks data from sources to dangerous sinks, such as user-controlled input reaching an eval call.checked 8 Oct 2026
Where it runs
- Platforms
- The installation page recommends its PyPI binary distribution for macOS and Linux; it says Windows use via WSL has worked but is not officially supported.checked 4 Oct 2026
The full review of Pysa
Pysa is a free, open-source static analyzer for Python that traces potentially unsafe data through code. It suits teams that want to define their own security checks and run analysis in a self-hosted workflow. Its focused taint analysis is a strong fit for Python code review, provided teams can manage its visibility limits, tuning needs, and memory demands.
Overview
Pysa tracks data from configured sources, such as user-controlled request input, to dangerous sinks such as an eval call. That focus helps identify risky flows across application code, rather than only isolated suspicious expressions. The repository says it can analyze codebases with millions of lines, but large-scale capability does not guarantee a smooth run: projects of similar size may freeze when the machine lacks enough memory.
Analysis is limited to the target repository and directories included in the configured search_path. Source code in dependencies outside those paths is invisible, which can leave flows across package boundaries unresolved. When Pysa encounters a function whose source it cannot access, it assumes the return value retains the input's taint. That conservative behavior can raise false positives and add review work.
Key features
Configurable models and sanitizers
Teams can define sources, sinks, features, and rules in taint.config, then annotate code with .pysa model files. Prewritten models cover built-in and common Python libraries, giving projects a useful base while still requiring teams to describe application-specific flows. Sanitizer models can mark parameters or return values as removing taint, which helps represent where data is made safe. The flexibility is valuable for codebases with distinct security boundaries, but it also means teams need the expertise and time to maintain meaningful models.
Editor and results workflow
Pyre supports the Language Server Protocol, and its VSCode extension connects to a running server. The documented workflow uses SAPP to ingest Pysa findings and provides a local web interface for viewing and filtering issues. This gives reviewers a way to triage results without relying only on raw output. The GitHub Action can run Pysa in CI and display findings in GitHub's Security code scanning UI; its default SAPP filters favor higher-signal output, with the trade-off that some genuine issues may be missed.
Installation uses pip install pyre-check in a Python virtual environment. Pysa requires Python 3.9 or later and currently relies on type information from Pyrefly.
Pricing
Pysa is open source under the MIT license. The Free plan costs nothing and covers Python static analysis installed with pip. There is no paid tier in this plan structure; users take on the work of configuring and running the tool themselves.
Platforms
Pysa supports Linux, macOS, Windows, extensions, and self-hosted deployment. It analyzes source code and supports CI/CD, making it suited to teams that want findings in their existing development workflow rather than a hosted-only service.
Who it's for
Pysa is best for Python teams that need configurable taint analysis, can maintain source and sink models, and want to keep analysis within their own environment. It is less suitable for teams seeking broad dependency visibility without configuring search paths, or those without enough memory for analysis on a large codebase. Teams with limited capacity to triage false positives should also weigh the default filtering trade-off before adopting it.
Pros and cons
- Configurable taint rules: Teams can model application-specific sources, sinks, and sanitizers instead of being limited to built-in checks.
- Local and CI review options: SAPP offers a local findings interface, while the GitHub Action can surface results in Security code scanning.
- Free and MIT-licensed: Teams can use and self-host the tool without a software charge.
- Bounded code visibility: Dependencies outside configured paths are not analyzed, and inaccessible function source can lead to false positives.
- Operational and coverage trade-offs: Large analyses may freeze on machines with insufficient memory, while higher-signal default filters can trade false positives for false negatives.
- Maintenance status: The Pyre repository was archived on June 26, 2026, and says Pysa moved to its own repository; teams should account for that transition when evaluating maintenance.
Alternatives
For a broader comparison, browse Static Application Security Testing Software.
- Skylos is worth considering for teams that want a freemium option with local CLI scans plus a cloud tier capped at one project, 10 stored scans, and seven-day history on its free plan.
- Horusec is another free, open-source option, with CLI and platform components under Apache License 2.0.
- Puma Scan may suit readers who prefer a free community edition with a paid End User license at $299 a year.
- Semgrep Code is an alternative for teams that want a free edition covering code and supply chain for up to 10 repositories and 10 contributors, with 60 AI credits.
- Snyk Open Source is a different option for software composition analysis, with a free plan capped at five projects.
- MobSF is another free, open-source choice, with its Community Edition licensed under GPL v3.
- Microsoft DevSkim may fit teams seeking a free MIT-licensed library, CLI, and IDE extensions.
- NodeJsScan is a free, self-hosted alternative with Docker or local setup.
Verdict
Choose Pysa if your team needs Python-specific taint analysis, wants control over its models and deployment, and can budget for tuning and resource use. Its strongest reason to choose it is the combination of configurable source-to-sink analysis and a self-hosted CI workflow at no software cost. Look elsewhere if you need dependencies analyzed automatically beyond configured paths, or if the risk of false positives and missed findings would make your review process hard to manage.
Alternatives to Pysa
- 1

Semgrep Code
Free planOpen sourceWebAPIExtensionLinux8.3From $15 a month - 2

GitHub CodeQL
Free planWebExtensionLinuxmacOS7.5From $30 a month - 3
OpenGrep
Free planOpen sourceAPILinuxmacOSSelf-hosted7.3Free plan - 4
Bandit
Free planOpen sourceExtensionLinuxmacOSSelf-hosted7.2Free plan - 5
gosec
Free planOpen sourceAPILinuxmacOSSelf-hosted7.2Free plan - 6

Skylos
Free planWebAPIExtensionLinux7.0Free plan
