Thanks to visit codestin.com
Credit goes to github.com

Skip to content

🐍 Customizable SVG badge generator for PyPI packages. Displays real-time statistics with multiple styles for your README.

License

Notifications You must be signed in to change notification settings

livrasand/PythonICO

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐍 PythonICO

PyPI FastAPI Python License

Beautiful badges for your Python packages

Generate live SVG badges with PyPI statistics for your projects

Live Demo β€’ Documentation β€’ API β€’ Contributing


Features

  • 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

Examples

Shields Style (GitHub README Compatible)

[![PyPI](https://pythonico.leapcell.app/pypi/requests.svg?style=shields&data=n,v,d)](https://pypi.org/project/requests/)

PyPI

Flat Style with Multi-Data

[![PyPI](https://pythonico.leapcell.app/pypi/django.svg?style=flat&data=v,d&color=brightgreen)](https://pypi.org/project/django/)

PyPI

Standard Style (Detailed)

[![PyPI](https://pythonico.leapcell.app/pypi/numpy.svg)](https://pypi.org/project/numpy/)

PyPI

Quick Start

Basic Usage

Simply replace package-name with your PyPI package name:

[![PyPI](https://pythonico.leapcell.app/pypi/package-name.svg)](https://pypi.org/project/package-name/)

With Custom Parameters

[![PyPI](https://pythonico.leapcell.app/pypi/package-name.svg?style=shields&data=n,v,d&color=blue)](https://pypi.org/project/package-name/)

Usage

Available Styles

Compact Badges (20px height)

  • shields - shields.io style, ideal for GitHub
  • flat - Modern flat design with rounded corners
  • flat-square - Flat design with square corners

Detailed Badges

  • standard - Classic PythonICO badge with complete information (default)
  • compact - Condensed one-line format
  • mini - Minimal badge with installation command only

Data Parameters

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

Data Usage Examples

# Single data point
![PyPI](https://pythonico.leapcell.app/pypi/numpy.svg?style=shields&data=version)

# Multiple data points (order matters)
![PyPI](https://pythonico.leapcell.app/pypi/pandas.svg?style=flat&data=n,v,d)

# Reorder as needed
![PyPI](https://pythonico.leapcell.app/pypi/scipy.svg?style=shields&data=d,v,u)

Available Colors

Named colors:

  • pypi - Official PyPI blue (#3775a9) - default
  • brightgreen, green, yellowgreen, yellow
  • orange, red, blue, lightgrey

Hexadecimal colors:

  • Any valid hex color: #007ec6, #4c1
# Named color
![PyPI](https://pythonico.leapcell.app/pypi/pytest.svg?style=shields&data=v&color=brightgreen)

# Custom hex color (URL encode the #)
![PyPI](https://pythonico.leapcell.app/pypi/mypy.svg?style=flat&data=n,v&color=%23ff6b6b)

Contributing

Contributions are welcome! Please:

  1. Fork the project
  2. Create a branch for your feature (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Guidelines

  • Follow the existing code style (Black + Ruff)
  • Add tests for new features
  • Update documentation as needed
  • Make sure all tests pass

Roadmap

  • 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

Acknowledgments


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

About

🐍 Customizable SVG badge generator for PyPI packages. Displays real-time statistics with multiple styles for your README.

Resources

License

Stars

Watchers

Forks