# Install basedpyright with Homebrew, Nix

Pyright fork with various improvements and built-in pylance features. Version 1.39.9 via Homebrew; verified 2026-06-28.

## Install

```sh
sudo av install brew:basedpyright
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install basedpyright
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#basedpyright
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ba/basedpyright/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:basedpyright
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/basedpyright>
- **Version:** 1.39.9
- **Source summary:** Pyright fork with various improvements and built-in pylance features
- **Homepage:** <https://docs.basedpyright.com>
- **Repository:** <https://github.com/DetachHead/basedpyright>
- **Upstream docs:** <https://docs.basedpyright.com/latest>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/basedpyright/-/basedpyright-1.39.9.tgz>
- **Last updated:** 2026-06-28T03:19:45Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- basedpyright (cli)
- basedpyright-langserver (cli)
- basedpyright (alias)
- basedpyright-langserver (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.39.9
- Package-manager updated: 2026-06-28
- Local data: ok
- Upstream repository: https://docs.basedpyright.com
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

basedpyright is a fork of Microsoft's Pyright type checker and language server for Python. It adds stricter defaults, additional diagnostics, PyPI distribution, version pinning, and reimplemented Pylance features for editors outside VS Code.

### Project history

The official documentation describes basedpyright as a Pyright fork with type-checking improvements, Pylance features, and more. Its documentation site and README both point to the GitHub repository and organize the project around benefits over upstream Pyright.

The release stream tracks upstream Pyright closely. The latest documentation canonical URL observed for this batch was v1.39.9, and GitHub release metadata for v1.39.9 names the paired Pyright version as 1.1.411.

### Adoption history

basedpyright is distributed through several developer channels: PyPI, the Visual Studio Marketplace, Open VSX, Sublime Text Package Control, Homebrew, and Nix according to the README badges and input metadata. That spread reflects its role as both a CLI checker and language server.

A major adoption hook is that users can install it from PyPI without Node.js, while the VS Code extension uses the same version to avoid different diagnostics between editor and CLI.

### How it is used

Users run basedpyright as a command-line type checker or basedpyright-langserver as an editor language server. Configuration follows Pyright-style project configuration in pyrightconfig.json or pyproject.toml.

The docs emphasize stricter defaults, new diagnostic rules, baseline support for adopting those rules in existing projects, and Pylance-like language-server behavior outside Microsoft's closed-source Pylance extension.

### Why package nerds care

basedpyright is important in package-manager culture because it repackages a Node-centered Python type checker as a Python-installable tool and aligns editor and CLI versions. That solves a real packaging pain point for Python projects that want type checking without a JavaScript toolchain.

It also shows a common modern fork pattern: take a successful corporate-backed open-source core, add stricter defaults and features withheld in a closed extension, and distribute it through every editor/package channel where Python developers already work.

### Timeline

- 2020s: basedpyright forked Pyright to add stricter checks, Pylance-like features, and packaging changes.
- 2020s: Documentation organized a Benefits over Pyright section covering baselines, better defaults, new diagnostics, and language-server improvements.
- 2026: v1.39.9 was published with Pyright 1.1.411 alignment according to GitHub release metadata.

### Related projects

- Pyright is the upstream Microsoft type checker that basedpyright forks.
- Pylance is Microsoft's closed-source VS Code extension whose features basedpyright reimplements for wider editor use.
- Mypy, Pyre, and pytype are related Python static type checkers, but basedpyright's direct lineage is Pyright.

### Sources

- <https://docs.basedpyright.com/latest>
- <https://docs.basedpyright.com/latest/benefits-over-pyright/>
- <https://github.com/DetachHead/basedpyright#readme>
- <https://github.com/DetachHead/basedpyright/releases>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for basedpyright. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: <project-root>/pyrightconfig.json, <project-root>/pyproject.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** basedpyright
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - basedpyright: normalized package name match | nixpkgs package indexes: pkgs/by-name/ba/basedpyright/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [pyrefly](https://www.automicvault.com/pkg/brew/pyrefly/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python, type-checker.
- [pyright](https://www.automicvault.com/pkg/brew/pyright/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python, type-checker.
- [ty](https://www.automicvault.com/pkg/brew/ty/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python, type-checker.
- [zuban](https://www.automicvault.com/pkg/brew/zuban/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python, type-checker.
- [cmake-language-server](https://www.automicvault.com/pkg/brew/cmake-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python.
- [mypy](https://www.automicvault.com/pkg/brew/mypy/) - Shares av.db curated category or tags: cli, developer-tools, python, type-checker.
- [pylyzer](https://www.automicvault.com/pkg/brew/pylyzer/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python.
- [python-lsp-server](https://www.automicvault.com/pkg/brew/python-lsp-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, python.
- [basedpyright](https://www.automicvault.com/pkg/npm/basedpyright/) - Same normalized package name appears in another local ecosystem. Shared terms: basedpyright, basedpyright-langserver, cli, developer, developer-tools.
- [basedpyright](https://www.automicvault.com/pkg/npm/basedpyright/) - Same normalized package name in another local ecosystem.

## Combined YAML source

View the package source record on GitHub. [combined/basedpyright.yml](https://github.com/automic-vault/db/blob/main/combined/basedpyright.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
