# Install isort with Homebrew, apt, Nix

Sort Python imports automatically. Version 8.0.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:isort
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install isort
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install isort
```

  Evidence: Debian stable package indexes: isort from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#isort
```

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

## Package facts

- **Package key:** brew:isort
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/isort>
- **Version:** 8.0.1
- **Source summary:** Sort Python imports automatically
- **Homepage:** <https://pycqa.github.io/isort/>
- **Repository:** <https://github.com/PyCQA/isort>
- **Upstream docs:** <https://github.com/PyCQA/isort#readme>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/ef/7c/ec4ab396d31b3b395e2e999c8f46dec78c5e29209fac49d1f4dace04041d/isort-8.0.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- isort (cli)
- isort-identify-imports (cli)
- isort (alias)
- isort-identify-imports (alias)

## Dependencies

- python@3.14

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 8.0.1
- Local data: ok
- Upstream repository: https://pycqa.github.io/isort/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

isort is a Python command-line tool and library for sorting imports alphabetically and grouping them into sections. Its README frames the tool as a way to sort imports automatically across CLI, library, editor, and pre-commit workflows.

### Project history

The PyCQA/isort repository was created in 2013, and PyPI metadata shows the 1.0.0 source distribution uploaded on 2013-12-10. Creator Timothy Crosley later described isort 5 as the refactoring of a ten-year-old project, placing isort among the early Python formatting tools that predated the Black-era formatter consolidation.

The project moved into the PyCQA ecosystem and grew from simple import ordering into a configurable formatter with profiles, editor integrations, pre-commit use, and documented upgrade guides. Its 5.0.0 upgrade guide calls that release the first major release in five years, while the changelog records Python 2 maintenance ending in the 4.3.x line and later compatibility work for newer Python versions.

### Adoption history

isort became common in Python projects because import order is easy to automate and painful to review by hand. It is packaged by Homebrew, Debian, Ubuntu, Nix, and PyPI, and the project advertises command-line, library, and editor/plugin use.

Its adoption is tied to the broader Python code-quality stack. Documentation and changelog entries repeatedly mention Black compatibility, built-in profiles, pyproject.toml support, pre-commit usage, and editor integration, making it a companion tool for formatters and linters rather than a standalone style checker.

### How it is used

Users run `isort` over files or projects to rewrite import blocks, or use it through pre-commit hooks, editor integrations, and CI checks. Official configuration documentation lists `.isort.cfg`, `pyproject.toml`, `setup.cfg`, `tox.ini`, and `.editorconfig` as project configuration surfaces.

The tool can be used conservatively to check import order or actively to rewrite files, with profiles and options controlling section names, known first-party modules, line length, Black compatibility, and skip rules.

### Why package nerds care

isort matters to package nerds because it shows how a small style tool becomes infrastructure: it appears in release tooling, pre-commit configs, editor extensions, CI images, and distribution packages. A version bump can affect thousands of downstream style checks even when runtime code is untouched.

It is also a useful marker for Python packaging eras: setup.cfg-era configuration, pyproject.toml adoption, Python 2 support removal, Black compatibility, and later trusted-publishing/release-infrastructure changes all show up in its history.

### Timeline

- 2013: PyCQA/isort repository created and isort 1.0.0 uploaded to PyPI.
- 2019: 4.3.5 documented as the final Python 2.7 maintenance release.
- 2020: 5.0.0 upgrade guide describes the first major release in five years.
- 2021: 5.10.0 changelog records Python 3.10 support and tomli-based pyproject loading.
- 2026: 8.0.0 and 8.0.1 releases continue Python-version and formatter-maintenance work.

### Related projects

- isort is commonly used alongside Black, Ruff, Flake8, pre-commit, editor organize-imports integrations, PyCQA tools, and Python packaging configuration files such as pyproject.toml and setup.cfg.

### Sources

- PyPI and GitHub metadata provide the 2013 public packaging/repository timeline.
- The changelog and upgrade guide document major Python-version, Black-compatibility, and release-line transitions.
- The official README and docs describe purpose, CLI/library/editor use, and configuration files.


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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: ./.isort.cfg, ./pyproject.toml, ./setup.cfg, ./tox.ini, ./.editorconfig
## Source Database Details

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

## Other Package-Manager Records

- Debian apt - isort - 6.0.1-1: normalized package name match | Debian stable package indexes: isort from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | utility for sorting Python imports | https://github.com/PyCQA/isort
- Debian apt - python3-isort - 6.0.1-1: normalized package name match | Debian stable package indexes: python3-isort from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | library for sorting Python imports (Python 3) | https://github.com/PyCQA/isort
- Nix - isort: normalized package name match | nixpkgs package indexes: pkgs/by-name/is/isort/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - isort - 5.6.4-1: normalized package name match | Ubuntu 24.04 LTS package indexes: isort from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | utility for sorting Python imports | https://github.com/timothycrosley/isort
- Ubuntu apt - python3-isort - 5.6.4-1: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-isort from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | library for sorting Python imports (Python 3) | https://github.com/timothycrosley/isort


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [reorder-python-imports](https://www.automicvault.com/pkg/brew/reorder-python-imports/) - Shares av.db curated category or tags: cli, code-formatting, developer-tools, imports, pre-commit.
- [black](https://www.automicvault.com/pkg/brew/black/) - Shares av.db curated category or tags: cli, code-formatting, developer-tools, formatter, pre-commit.
- [djhtml](https://www.automicvault.com/pkg/brew/djhtml/) - Shares av.db curated category or tags: cli, code-formatting, developer-tools, formatter, pre-commit.
- [gersemi](https://www.automicvault.com/pkg/brew/gersemi/) - Shares av.db curated category or tags: cli, code-formatting, developer-tools, formatter, pre-commit.
- [darker](https://www.automicvault.com/pkg/brew/darker/) - Shares av.db curated category or tags: cli, code-formatting, developer-tools, formatter, python.
- [ruff](https://www.automicvault.com/pkg/brew/ruff/) - Shares av.db curated category or tags: cli, developer-tools, linter, python.
- [abi3audit](https://www.automicvault.com/pkg/brew/abi3audit/) - Shares av.db curated category or tags: cli, developer-tools, python.
- [air](https://www.automicvault.com/pkg/brew/air/) - Shares av.db curated category or tags: cli, code-formatting, developer-tools, formatter.

## Combined YAML source

View the package source record on GitHub. [combined/isort.yml](https://github.com/automic-vault/db/blob/main/combined/isort.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
