Recent insights into PyPI package adoption and usage patterns
This repository contains automated BigQuery analytics and reports for PyPI packages.
Report Date: 2026-11-15
Quarterly download trends by major version over the last 3 years. Shows version adoption patterns and migration trends across releases.
| Metric | Last 30 Days (Actual) | Last 90 Days (Actual) |
|---|---|---|
| Total Downloads | 80,288 | 235,832 |
| Countries Reached | 57 | 77 |
| CI/CD Installs | 63.9% | 59.9% |
| UV Adoption | 40.6% | 44.9% |
| MCP Usage | 820 | 956 |
An architectural shift implemented on August 24, 2026 represents one of the most significant corrections to PyPI's download tracking history. Prior to this update, PyPI's logging infrastructure tracked downloads by matching a broad storage prefix (/packages///...). This meant any request for any file associated with a package release was logged as a full package download. The official PyPI Blog post details exactly what was bloating those numbers, how severe the drop was, and how it impacts historical data:
What Was Artificially Inflating the Data?
The primary culprit was the adoption of PEP 658 metadata sidecars. Modern Python package installers (like pip or uv) often fetch just the lightweight .metadata file of a wheel to resolve dependencies before deciding whether they actually need to download the massive wheel itself. PyPI discovered that these metadata requests accounted for roughly 40% of all logged traffic. Other non-distribution files that were being erroneously counted included:
.asc files: Legacy GPG signatures (deprecated for new uploads in 2023 but still served). Legacy formats: Leftover .egg, .exe, .msi, and .rpm files from older packaging eras.
The Scale of the "Downward Shift"
The impact of filtering out these files was immediate and permanent. Across all of PyPI, daily baseline downloads historically fluctuated between 4.5 billion on weekends to over 7 billion midweek. After the August 24 patch, that entire curve stepped down sharply because only files ending in .whl, .tar.gz, or .zip are now recorded. For a real-world example, PyPI administrators tracked urllib3 traffic during the transition week:
Before August 24: urllib3 averaged ~74 million logged "downloads" a day, but 39% of those were actually metadata or accessory files, not the actual package. After August 25: The "other" file count dropped to exactly 0%, shrinking the package's daily download metric overnight to reflect only real distribution file downloads.
Key Insights:
United States dominance (77.9% in 30d, 80.9% in 90d) consistent across periods
- 57 countries (30d), 77 countries (90d) demonstrates global reach
MCP (Model Context Protocol) is Anthropic's protocol for connecting AI assistants like Claude to external tools and data sources. When developers use Claude Desktop with MCP servers, they often install Python packages via uvx (uv's tool runner).
Since MCP servers don't explicitly identify themselves in PyPI logs, we use proxy signals with significant limitations:
- HIGH Confidence:
uvxsubcommand usage (MCP's recommended pattern, but also used for other tools) - Contextual: UV vs pip adoption trends (UV is MCP's recommended installer)
- Observational: CI vs non-CI patterns (shows usage context, not MCP specifically)
Important Limitations:
- Install vs Usage: PyPI data shows package downloads, not actual execution - packages may be installed but never run
- uvx Ambiguity: The
uvxcommand is used for many tools beyond MCP servers (any Python CLI tool can be run via uvx) - Non-CI Context: Non-CI downloads don't isolate MCP usage - most PyPI downloads are non-CI regardless of use case
- CI Detection Issues: The
details.cifield in BigQuery is heuristically derived from user-agent strings (checking for patterns like "github", "travis", "jenkins") and is unreliable - many CI systems don't identify themselves, and some non-CI tools may match the patterns - User-Agent Limitations: Cannot distinguish MCP from other UV usage without access to raw user-agent strings, which are not available in the public BigQuery dataset
- Proxy Signals Only: All MCP detection relies on indirect signals (installer choice, subcommand usage) rather than explicit MCP identification
Shows which installer tool was used to download the package (pip, uv, or poetry). UV is a proxy for MCP since MCP clients use UV.
|
30 Days UV: 40.6% of downloads (32,606) |
90 Days UV: 44.9% of downloads (105,820) |
Breaks down all UV downloads by which UV subcommand was used. The uvx command is the standard pattern MCP clients use to run MCP servers (e.g., Claude Desktop, Cline, etc.).
|
30 Days 820 uvx downloads = HIGH confidence MCP |
90 Days 956 uvx downloads = HIGH confidence MCP |
UV Subcommand Meanings:
sync- Synchronize project dependencies β CI/CD pipelines, developers syncing environmentspip install- UV's pip-compatible install command β CI/CD, automated builds, legacy workflows- no subcommand - UV downloads without subcommand data β Older UV versions or incomplete logging
run- Run a script in a virtual environment β Developers, test runners, automation scriptstool install- Install a tool globally β Developers setting up their environmentuvx- Run a tool without installing it β MCP clients (Claude Desktop, Cline), developers trying toolslock- Generate a lockfile for dependencies β Developers, CI/CD for reproducible buildspip compile- Compile requirements files β CI/CD, dependency management workflowsadd- Add a dependency to the project β Developers adding new packagestool run- Run an installed tool β Developers, automation scriptstool upgrade- Upgrade an installed tool β Developers maintaining tools
Separates automated CI/CD installs from other downloads for pip, uv, poetry, and other installers.
|
30 Days UV: 26.2% non-CI (8,538 downloads) |
90 Days UV: 39.6% non-CI (41,922 downloads) |
Time series showing daily UV download trends. Highlights confirmed uvx subcommand usage (MCP pattern) alongside total UV downloads to visualize MCP adoption patterns over time.
|
30 Days 820 uvx downloads over 30 days |
90 Days 956 uvx downloads over 90 days |
Key Findings:
|
30-Day Analysis:
MCP usage is detectable but small. The broader story is UV's growth as a modern Python installer. |
90-Day Analysis:
MCP usage is detectable but small. The broader story is UV's growth as a modern Python installer. |
Categorizes downloads by platform based on OS and distribution detection. Identifies AWS (Amazon Linux), Containers (Alpine), Enterprise (RHEL), Ubuntu, Debian, macOS, Windows, and other platforms. Shows the overall platform mix of package users.
|
30 Days |
90 Days |
Shows the distribution of downloads across different deployment environments, automatically categorized based on OS, distribution, libc type, and CI detection. Categories may include containers, cloud VMs, CI/CD pipelines, and developer workstations.
|
30 Days |
90 Days |
Shows CPU architecture breakdown (x86_64, ARM64, etc.) detected from download metadata. Tracks adoption of ARM-based systems like AWS Graviton and Apple Silicon.
|
30 Days |
90 Days |
Compares traditional enterprise Linux distributions (RHEL, CentOS) against cloud-native platforms (Amazon Linux, Alpine). Indicates adoption patterns in regulated vs cloud-first environments.
|
30 Days |
90 Days |
Shows the distribution of C library implementations (glibc vs musl). musl libc is a strong indicator of containerized deployments, particularly Alpine Linux in Docker/Kubernetes.
|
30 Days |
90 Days |
Categorizes downloads by deployment scenario based on OS type, Linux distribution, and CI detection. Shows patterns like containerized pipelines (Alpine+CI), cloud automation (Amazon Linux+CI), enterprise Linux (RHEL), CI environments, developer workstations (macOS/Windows), and other contexts.
|
30 Days |
90 Days |
Key deployment metrics at a glance: container adoption, cloud provider usage, enterprise deployment, CI/CD percentage, ARM architecture adoption, and musl libc usage.
|
30 Days |
90 Days |
This repository is automatically updated weekly by GitHub Actions:
- Schedule: Weekly on Mondays at 6 AM UTC (2 AM ET)
- Authentication: Service account JSON key stored in GitHub secrets
- Manual trigger: Available via GitHub Actions UI
- Setup guide: See SETUP.md
Data Source: Google BigQuery public dataset bigquery-public-data.pypi.file_downloads
Analysis Period:
- 30-day reports: Last 30 days from data fetch date
- 90-day reports: Last 90 days from data fetch date
Update Frequency:
- Automated: Daily via GitHub Actions
- Caching: Data fetched once per day, cached locally to minimize BigQuery costs
- Cache Management: Old cache files automatically removed after successful new fetch
- Manual trigger: Available for on-demand updates
Privacy: All data comes from PyPI's public dataset. No personal information is collected or stored.
Analytics powered by Google BigQuery and GitHub Actions
























