Beautiful badges for your Python packages
Generate live SVG badges with PyPI statistics for your projects
Live Demo β’ Documentation β’ API β’ Contributing
- 6 Badge Styles: Standard, Compact, Mini, Shields, Flat, Flat-Square
- Customizable Data: Version, downloads, license, required Python, last update
- Flexible Colors: Predefined palette or custom hexadecimal colors
- High Performance: Smart cache with configurable TTL
- Async/Fast: Built with FastAPI for maximum performance
- REST API: Complete programmatic access
- Web Interface: Interactive generator with real-time preview
[](https://pypi.org/project/requests/)[](https://pypi.org/project/django/)[](https://pypi.org/project/numpy/)Simply replace package-name with your PyPI package name:
[](https://pypi.org/project/package-name/)[](https://pypi.org/project/package-name/)shields- shields.io style, ideal for GitHubflat- Modern flat design with rounded cornersflat-square- Flat design with square corners
standard- Classic PythonICO badge with complete information (default)compact- Condensed one-line formatmini- Minimal badge with installation command only
Use the data parameter to specify what information to display. Order matters - data appears in the order specified:
| Parameter | Alias | Description | Example |
|---|---|---|---|
name |
n |
Package name | requests |
version |
v |
Latest version | v2.31.0 |
downloads |
d |
Weekly downloads | 52M dl/w |
license |
l |
License | Apache 2.0 |
python |
py |
Required Python | >=3.7 |
updated |
u |
Last update | 2mo ago |
# Single data point

# Multiple data points (order matters)

# Reorder as needed
Named colors:
pypi- Official PyPI blue (#3775a9) - defaultbrightgreen,green,yellowgreen,yelloworange,red,blue,lightgrey
Hexadecimal colors:
- Any valid hex color:
#007ec6,#4c1
# Named color

# Custom hex color (URL encode the #)
Contributions are welcome! Please:
- Fork the project
- Create a branch for your feature (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the existing code style (Black + Ruff)
- Add tests for new features
- Update documentation as needed
- Make sure all tests pass
- Support for animated badges
- More badge styles
- Distributed cache (Redis)
- Support for private packages
- Automatic dark mode
- Export to PNG/WebP
- Advanced metrics (issues, stars, contributors)
- API rate limiting
- CDN integration
- Inspired by nodei.co by Rod Vagg
- Badge styles based on shields.io
- PyPI data via PyPI JSON API
- Download statistics via pypistats.org
Legal Notice: PyPI is a registered trademark of the Python Software Foundation. PythonICO is an independent service not affiliated with, endorsed by, or sponsored by the PSF or PyPI. This service generates badges using publicly available data from the PyPI registry.
Made with β€οΈ and Python