icon-gen-ai 0.1.4

Generate customizable icons from Iconify with easy export to PNG, SVG, WebP

icon-gen

Generate customizable icons from Iconify with easy export to PNG, SVG, WebP formats.

Features

• Access 200,000+ icons from Iconify
• Customize colors and sizes
• Custom backgrounds
• Adjustable border radius
• Export to SVG format
• Simple and intuitive API
• CLI and Python API

Installation

pip install icon-gen

Quick Start

from icon_gen import IconGenerator

# Initialize generator
generator = IconGenerator(output_dir="output")

# Generate multiple icons at once
ai_icons = {
    'openai': 'simple-icons:openai',
    'gemini': 'simple-icons:googlegemini',
    'mistral': 'simple-icons:mistralai',
    'claude': {
        'url': 'https://upload.wikimedia.org/wikipedia/commons/b/b0/Claude_AI_symbol.svg'
    }
}

generator.generate_batch(ai_icons, color='white', size=256)

Example Output

Finding Icons

Browse available icons at Iconify

Icon naming format: collection:icon-name

• simple-icons:openai - Company logos
• mdi:github - Material Design Icons
• fa6-solid:scale-balanced - Font Awesome icons
• heroicons:scale - HeroIcons

Examples

Check out the examples/ directory for more use cases:

• generate_ai_icons.py - Generate AI model icons (Claude, OpenAI, Gemini)
• generate_judge_icon.py - Generate legal/law icons

Development

# Clone the repository
git clone https://github.com/yauheniya-ai/icon-gen.git
cd icon-gen

# Install all dependencies (including dev tools)
uv sync

# Run tests
uv run pytest

License

MIT License - see LICENSE file for details

Author

Yauheniya Varabyova ([e-mail])

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.