No known security advisories.
The current version has no OSV.dev malware reports and no critical or high-severity vulnerabilities.
python-on-whales has 13.8M monthly downloads and 707 GitHub stars. Version 0.81.0 supports Python <4,>=3.8, first published in 2020.
It is actively maintained under a permissive license, last released in Mar 2026.
It is built on top of pydantic and typing-extensions. It is used by 86 tracked packages, including prefect-docker, truss and agentex-sdk.
Package Insights
Package Risks
- No releases in 110 days despite active commits
Score breakdown - each component scores 0-100, weighted by percentage
Maintenance
90
Popularity
61
Adoption
70
Community
60
Provenance
100
How the maintenance status was determined
Last commit
9 days ago
Monthly downloads
13,815,823
•
Active
Activity within 30 days
Stable
Activity within 31-180 days
Minimal
Activity within 181-365 days, or no activity data
At Risk
No activity for > 365 days, but > 10,000 monthly downloads
Archived
Repository flagged as archived on GitHub
How the popularity category was determined
Monthly downloads
13,815,823
Stars
707
Stars per 1k downloads
0.05
•
Industry Standard
> 10,000,000 monthly downloads
Hidden Gem
< 0.5 stars per 1k downloads and > 100,000 monthly downloads
Community Favorite
> 5 stars per 1k downloads
Rising Star
Balanced ratio of stars to downloads
Unknown
Fewer than 1,000 monthly downloads, or no star data
How download momentum is calculated
Week daily avg
445,030
Month daily avg
460,527
Momentum
-3.4%
((week_daily_avg - month_daily_avg) / month_daily_avg) * 100Python version support tiers
requires_python
<4,>=3.8
Cutting Edge
Minimum supported version is 3.12 or newer
Modern
Minimum supported version is 3.9, 3.10, or 3.11
•
Legacy
Supports 3.8 or older (or Python 2)
Unknown
No requires_python specified or unparseable
License categories
License
MIT License
•
Permissive
MIT, Apache, BSD, ISC, Unlicense, CC0, etc.
Copyleft
GPL, LGPL, AGPL, MPL, EPL, etc.
Proprietary
Commercial, all rights reserved, custom EULAs
Unknown
No license specified, or none of the above match
How the release cadence was determined
Last release
119 days ago
Total releases
102
Releases/year
17.9
•
Rapid
Last release within 365 days and > 12 releases/year
Regular
Last release within 365 days
Slow
Last release 366-730 days ago
Stalled
Last release > 730 days ago, or no releases
Unknown
No usable release date available
How contributor risk was determined
Contributors
81
Monthly downloads
13,815,823
High Load
≤ 2 contributors and ≥ 50,000 monthly downloads
Moderate Load
< 10 contributors and ≥ 500,000 monthly downloads
Low Load
< 25 contributors and ≥ 5,000,000 monthly downloads, or sole maintainer with ≥ 10,000 monthly downloads
•
Balanced
Enough contributors for the package's popularity
Unknown
No contributor data available
Engagement
67
Issue Burden
70.7
per 1k stars
Discussions
11.3
per 1k stars
Fork Ratio
62.3%
contrib / forks
Stale Release
110d
PR Velocity
Quiet
Weekly Downloads
GitHub Stars
Not all downloads include detailed metadata. Breakdowns reflect the subset that does.
Downloads by OS
Linux
321.4K
macOS
595
Windows
345
Python Versions
3.10
46.6%
148.7K
3.12
16.2%
51.8K
3.13
14.3%
45.5K
3.11
12.7%
40.5K
3.14
10.2%
32.7K
Top Countries
1.
US
313.2K
US
2.
DE
2.2K
DE
3.
NL
2.1K
NL
4.
IE
1.6K
IE
5.
NO
561
NO
6.
AU
411
AU
7.
IN
284
IN
8.
FR
256
FR
9.
IL
255
IL
10.
SG
229
SG
Dependencies
2
- pydantic !=2.0.*,<3,>=2
- typing-extensions
Used By
86
- prefect-docker
- truss
- agentex-sdk
- otter-grader
- docker-mcp
- lookout-cli
- buildrunner
- magic-pocket-cli
- dtaas
- rigelcore
- octopize-deploy-tool
- reflowfy
- pkr
- pymediawikidocker
- seaplane
- kelvin-sdk
- gama-cli
- testshed
- missim-cli
- featurebyte
- maia-toolkit
- odoo-toolkit
- ess-community-integration-tests
- crate-anon
- citros
- pytest-docker-compose-v2
- wanna-ml
- terminaluse
- mpyl
- idegym-image-builder
- dynamic-des
- docky
- aws-stepfunctions-toolkit
- namekoplus
- llmstack
- testcontainers-on-whales
- skapp
- aws-cdk-lambda-poetry-asset
- amoni
- compose-micromanager
- xbow-validation-benchmarks-sdk
- autocode-py
- monet-bundle
- kapla-cli-core
- orche
- posit-bakery
- safehouse
- langrocks
- sentential
- pip-autocompile
Package Information
License
MIT License
First Release
October 24, 2020
Last Release
4 months ago
Last Commit
1 week ago
Latest Version
0.81.0
Total Releases
102
Contributors
81
Open PRs
1
Archived
No
Wheels
py3
Tracking Since
January 6, 2026
Data Updated
July 5, 2026
Data Freshness
Fresh