About Black
Black is the uncompromising Python code formatter. By using it, you agree to cede control over minutiae of hand-formatting.
Confront a dark world in BLACK
Black is the uncompromising Python code formatter. By using it, you agree to cede control over minutiae of hand-formatting.
Stable style
- Fix unstable formatting of annotated assignments whose subscript annotation contains
an inline comment (e.g. x: list[ # pyright: ignore[...]) (#5130)
- Preserve inline comments (including # type: ignore) immediately before a
# fmt: skip line, avoiding AST equivalence failures (#5139)
Packaging
Documentation
- Add Neovim integration guide covering conform.nvim, ALE, and simple command approaches
(#5124)
| Publisher | Python Software Foundation |
|---|---|
| Author | Łukasz Langa |
| Version | 26.5.1 |
| Release date | 2026-05-18 |
| License | MIT |
| Installer type | portable |
| Architecture | x64 |
| Package ID | psf.black |
winget install --id=psf.black -ewinget upgrade --id=psf.black -ewinget uninstall --id=psf.black -eBlack adds this command to the command line: black.
Highlights
This release introduces the new 2025 stable style (#4558), stabilizing
the following changes:
- Normalize casing of Unicode escape characters in strings to lowercase (#2916)
- Fix inconsistencies in whether certain strings are detected as docstrings (#4095)
- Consistently add trailing commas to typed function parameters (#4164)
- Remove redundant parentheses in if guards for case blocks (#4214)
- Add parentheses to if clauses in case blocks when the line is too long (#4269)
- Whitespace before # fmt: skip comments is no longer normalized (#4146)
- Fix line length computation for certain expressions that involve the power operator (#4154)
- Check if there is a newline before the terminating quotes of a docstring (#4185)
- Fix type annotation spacing between * and more complex type variable tuple (#4440)
The following changes were not in any previous release:
- Remove parentheses around sole list items (#4312)
- Generic function definitions are now formatted more elegantly: parameters are
split over multiple lines first instead of type parameter definitions (#4553)
Stable style
- Fix formatting cells in IPython notebooks with magic methods and starting or trailing
empty lines (#4484)
- Fix crash when formatting with statements containing tuple generators/unpacking
(#4538)
Preview style
- Fix/remove string merging changing f-string quotes on f-strings with internal quotes
(#4498)
- Collapse multiple empty lines after an import into one (#4489) …
Yes. Black is free and open-source software released under the MIT license.
The latest version is 26.5.1, released on May 18, 2026.
The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with d3d971d1e86ddde7f9c114e4b8170cf1d5df841c021014c288a08caf699e1dd8.
Black runs on Windows and is available for 64-bit (x64) systems.
Open Settings › Apps › Installed apps, find Black and select Uninstall. From the command line, run winget uninstall --id=psf.black -e.
Yes. Black is available as a portable program (black_windows.exe, 64-bit (x64)) that runs without installation. Copy it to any folder or USB drive and run it from there.