Star History
Add Live Star History & Verified Badges to README.md
Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.
Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.
[](https://githubrepo.cloud/repo/psf/black?utm_source=readme_chart)
Compact Shields-style badges for your README header. Shows real-time stars and global ranking.
[](https://githubrepo.cloud/repo/psf/black?utm_source=readme_badge) [](https://githubrepo.cloud/repo/psf/black?utm_source=readme_badge) [](https://githubrepo.cloud/repo/psf/black?utm_source=readme_badge)
Momentum
+1K
STARS · LAST 30 DAYS
35
PER DAY
#74
MOST-STARRED Python
| Window | 7 days | 30 days | 90 days |
|---|---|---|---|
| Stars gained | +245 | +1K | +3.2K |
| Per day | 35 | 35 | 35 |
| Forks gained | +15 | +58 | +146 |
black gained 1K stars in the last 30 days, about 35 a day, and now has 41.9K. It is about 9 years old and has averaged roughly 4.7K stars a year. It ranks #74 among Python repositories and #310 across all languages on GitHubRepo.
Trending Record
7
DAYS ON TRENDING
#3330
BEST RANK
Oct 7, 2026
FIRST APPEARANCE
Active
STATUS TODAY
black has maintained a continuous presence across global trending indexes, peaking at #3330. Below is the 30-day activity profile:
💡 Overview
black is an open-source project written in Python: The uncompromising Python code formatter.
Engineered for speed, consistency, and developer ease, it solves common hurdles in autopep8, code, codeformatter. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.
⚡ Key Features
Optimized execution pipeline written in Python for predictable speed.
Zero-friction configuration with comprehensive sensible defaults out of the box.
Cross-platform runtime support across Linux, macOS, and Windows environments.
Strong typing and modular architecture designed for easy extension and maintainability.
Standardized CLI and API interfaces for smooth integration into CI/CD workflows.
Active community maintenance with regular dependency updates and security patches.
📥 Installation
$ pip install black
⚙ System Requirements
Platforms
- • macOS
- • Linux
- • Windows
Runtime & Dependencies
Python >= 3.9, pip, virtualenv
Architecture
x86_64, ARM64 (Apple Silicon & Graviton)
🧠 How It Works
black coordinates its core functionality through a modular Python pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.
🎯 Production Use Cases
Production System Integration
Embed black into Python backend services to handle core application logic.
CI/CD Automated Pipelines
Run automated validation, builds, and integration suites during deployments.
Developer Tooling & Workflows
Accelerate developer onboarding with pre-configured project utilities.
Open Source Extension
Fork and customize internal modules under the repository's open MIT license.
🚀 Getting Started
Install black using your package manager: `pip install black`
Initialize your project workspace or configuration file for black.
Import black into your codebase or invoke it directly from your terminal.
Execute your test suite or run `black --help` to verify successful setup.
👍 Strengths
⚠️ Considerations
⇄ Alternatives & Direct Competitors
👥 Who Should Use This
Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads.
🏆 Nearby in the Rankings
psf/black is currently ranked #310 by stars across every repository tracked on GitHubRepo. These are adjacent projects:
| Rank | Repository | Language | Stars | Action |
|---|---|---|---|---|
| #305 | exelban/stats | Swift | ★ 42.3K | Compare ↗ |
| #306 | fastlane/fastlane | Ruby | ★ 42.2K | Compare ↗ |
| #307 | duckdb/duckdb | C++ | ★ 42K | Compare ↗ |
| #308 | XTLS/Xray-core | Go | ★ 41.9K | Compare ↗ |
| #309 | LizardByte/Sunshine | C++ | ★ 41.9K | Compare ↗ |
| #310 | psf/black This Project | Python | ★ 41.9K | |
| #311 | tabler/tabler | Astro | ★ 41.8K | Compare ↗ |
| #312 | AstrBotDevs/AstrBot | Python | ★ 41.7K | Compare ↗ |
| #313 | herdrdev/herdr | Rust | ★ 41.7K | Compare ↗ |
| #314 | apache/dubbo | Java | ★ 41.6K | Compare ↗ |
| #315 | GyulyVGC/sniffnet | Rust | ★ 41.3K | Compare ↗ |
Frequently Asked Questions
What does black do? +
The uncompromising Python code formatter
What language is black written in? +
The primary language is Python. Topics include: autopep8, code, codeformatter, formatter, gofmt.
Is black actively maintained? +
Yes, the last recorded push was on Oct 7, 2026 with 261 open issues being tracked.
How many stars does black have? +
black has 41,874 stars and 2,912 forks on GitHub.
How does black rank among GitHub repositories? +
With 41,874 stars, psf/black is ranked #310 globally across all repositories tracked on GitHubRepo and #74 among Python projects.
What license is black distributed under? +
The repository reports a MIT license. Always verify the repository LICENSE file for legal terms.