---
id: black
version: "26.5.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# black — The uncompromising code formatter.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install black
uv add black
poetry add black

## Description

[![Black Logo](https://raw.githubusercontent.com/psf/black/main/docs/_static/logo2-readme.png)](https://black.readthedocs.io/en/stable/)

<h2 align="center">The Uncompromising Code Formatter</h2>

<p align="center">
<a href="https://github.com/psf/black/actions"><img alt="Actions Status" src="https://github.com/psf/black/workflows/Test/badge.svg"></a>
<a href="https://black.readthedocs.io/en/stable/?badge=stable"><img alt="Documentation Status" src="https://readthedocs.org/projects/black/badge/?version=stable"></a>
<a href="https://coveralls.io/github/psf/black?branch=main"><img alt="Coverage Status" src="https://coveralls.io/repos/github/psf/black/badge.svg?branch=main"></a>
<a href="https://github.com/psf/black/blob/main/LICENSE"><img alt="License: MIT" src="https://black.readthedocs.io/en/stable/_static/license.svg"></a>
<a href="https://pypi.org/project/black/"><img alt="PyPI" src="https://img.shields.io/pypi/v/black"></a>
<a href="https://pypi.org/project/black"><img alt="Supported Python Versions" src="https://img.shields.io/pypi/pyversions/black?color=brightgreen"></a>
<a href="https://pepy.tech/project/black"><img alt="Downloads"...

## AI interpretation — verify before relying

Black is an opinionated Python code formatter that automatically reformats entire files to enforce a consistent, deterministic style, eliminating manual formatting decisions and code review friction.

Verdict: Black is a mature, actively maintained formatter with zero known vulnerabilities, permissive MIT licensing, and minimal install friction. The opinionated design trades configuration flexibility for determinism and reduced code review overhead—ideal for teams prioritizing consistency over customization.

[View on SkillFed](https://skillfed.io/packages/black) · [View on PyPI](https://pypi.org/project/black/)