# black を Homebrew, apk, apt, dnf, Nix, winget でインストール

black のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:black
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install black
```

  証拠: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add black
```

  証拠: Alpine Linux edge package indexes: black from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install black
```

  証拠: Debian stable package indexes: black from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install black
```

  証拠: Fedora Rawhide package metadata: black from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#black
```

  証拠: nixpkgs package indexes: black from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

### Windows

- winget (92%):

```sh
winget install --id psf.black -e
```

  証拠: Windows Package Manager source index: psf.black from https://cdn.winget.microsoft.com/cache/source.msix

## パッケージ情報

- **パッケージキー:** brew:black
- **パッケージマネージャ:** Homebrew
- **バージョン:** 26.5.1
- **ソース概要:** Python code formatter
- **ホームページ:** <https://black.readthedocs.io/en/stable/>
- **リポジトリ:** <https://github.com/psf/black>
- **最終更新:** 2026-06-09T10:24:11Z
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- black (エイリアス)
- blackd (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 26.5.1
## プロジェクトの歴史と使われ方

Black is the opinionated Python code formatter whose promise is deterministic, low-choice formatting. It became one of the defining Python developer tools of the late 2010s and 2020s, normalizing gofmt-style formatting in Python projects.

### プロジェクトの歴史

Black was first published to PyPI in March 2018 and its GitHub repository was created the same day. Its README and documentation present it as 'The Uncompromising Code Formatter': users trade manual formatting control for speed, determinism, smaller diffs, and fewer style arguments.

The project is now maintained under the Python Software Foundation GitHub organization. Its documentation codifies a stability policy, preview style, and yearly stable style cadence, allowing Black to support new Python syntax while preserving formatting predictability for established projects.

### 採用の歴史

Black spread rapidly through PyPI, pre-commit, CI, editor integrations, and Linux/macOS/Windows package managers. The README lists major projects and organizations using it, including pytest, Django, pandas, SQLAlchemy, Home Assistant, Zulip, Dropbox, Lyft, Mozilla, Quora, and others.

Its adoption changed Python package maintenance culture: many projects stopped debating PEP 8 edge cases in reviews and delegated whitespace, wrapping, quote normalization, and import-adjacent formatting decisions to a pinned formatter version.

### 使われ方

The standard CLI workflow is black {source_file_or_directory}; Black reformats files in place and can also run as python -m black. Configuration normally lives in a project's pyproject.toml under [tool.black], with global fallback files at $XDG_CONFIG_HOME/black or ~/.config/black on Unix-like systems and ~/.black on Windows.

Black is commonly run from pre-commit hooks, GitHub Actions, editors, and CI jobs. Its documentation recommends the psf/black-pre-commit-mirror hook for version-control integration and warns that blackd does not use pyproject.toml configuration.

### パッケージ好きにとっての重要性

Black is package-nerd significant because it made formatter pinning a first-class dependency-management concern in Python. A Black version in pyproject.toml, pre-commit config, CI images, or distro packages can affect every formatted file in a repository, so release notes and stability guarantees matter more than they do for many CLIs.

It also helped shift Python packaging metadata toward pyproject.toml as a shared control plane: the same file that PEP 518 introduced for builds became the obvious place to store Black's project style. Black's presence in Homebrew, Debian, Ubuntu, Fedora, Alpine, Nix, and winget mirrors its role as both Python package and general developer workstation tool.

For maintainers, Black became shorthand for removing a category of bikeshed from reviews. For downstream packagers, it is a high-visibility fast-moving Python application that must track supported Python versions, parser behavior, compiled wheels, pre-commit mirrors, and reproducible CLI behavior.

### タイムライン

- 2018-03-14: Black 18.3a0 is uploaded to PyPI and the GitHub repository is created.
- 2019: The project gains broad public visibility through talks, docs, badges, and early adopter projects.
- 2022-01-29: Black 22.1.0 is published as the first non-alpha, stable-style release line.
- 2020s: Black becomes widely packaged across Homebrew, Linux distributions, Nix, and winget while remaining centered on PyPI and pre-commit workflows.
- 2024-2026: Black's changelog documents yearly stable-style releases and preview/unstable channels for future formatting changes.

### Related projects

- Black's README explicitly situates it near gofmt and lists autopep8 and YAPF among related Python formatters through repository topics.
- It is commonly paired with pre-commit, CI systems, editor integrations, and Python packaging metadata in pyproject.toml.

### ソース

- <https://black.readthedocs.io/en/stable>
- <https://black.readthedocs.io/en/stable/integrations/source_version_control.html>
- <https://black.readthedocs.io/en/stable/the_black_code_style/index.html#stability-policy>
- <https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html>
- <https://github.com/psf/black#readme>
- <https://pypi.org/project/black/>
- source_facts.package-manager


## セキュリティノート

formula declares a Homebrew service.

- **Geiger リスク:** orange / 中
- formula declares a Homebrew service


## 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: pyproject.toml, $XDG_CONFIG_HOME/black, ~/.config/black
- Windows: pyproject.toml, ~\.black
## 他のパッケージマネージャ記録

- Debian apt - black - 25.1.0-3+deb13u1: normalized package name match | Debian stable package indexes: black from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | uncompromising Python code formatter (Python 3) | https://github.com/psf/black
- Debian apt - python-black-doc - 25.1.0-3+deb13u1: normalized package name match | Debian stable package indexes: python-black-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | uncompromising Python code formatter (common documentation) | https://github.com/psf/black
- Nix - black: normalized package name match | nixpkgs package indexes: black from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- Ubuntu apt - black - 24.2.0-1ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: black from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | uncompromising Python code formatter (Python 3) | https://github.com/psf/black
- Ubuntu apt - python-black-doc - 24.2.0-1ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: python-black-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | uncompromising Python code formatter (common documentation) | https://github.com/psf/black
- apk - black - 26.3.0-r1: normalized package name match | Alpine Linux edge package indexes: black from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | The uncompromising Python code formatter | https://github.com/psf/black
- apk - black-bash-completion - 26.3.0-r1: normalized package name match | Alpine Linux edge package indexes: black-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for black | https://github.com/psf/black
- apk - black-fish-completion - 26.3.0-r1: normalized package name match | Alpine Linux edge package indexes: black-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for black | https://github.com/psf/black
- apk - black-pyc - 26.3.0-r1: normalized package name match | Alpine Linux edge package indexes: black-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for black | https://github.com/psf/black
- apk - black-zsh-completion - 26.3.0-r1: normalized package name match | Alpine Linux edge package indexes: black-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for black | https://github.com/psf/black
- dnf - black - 26.5.1-2.fc45: normalized package name match | Fedora Rawhide package metadata: black from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | The uncompromising code formatter | https://github.com/psf/black
- winget - psf.black: normalized package name match | Windows Package Manager source index: psf.black from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/black.yml](https://github.com/mxcl/pkgdb/blob/main/combined/black.yml)


## ソース

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph