icon-gen-ai 0.2.3

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

icon-gen-ai

Generate customizable icons from Iconify, direct URLs, or local files with easy export to PNG, SVG, WebP formats.

Features

• AI-assisted icon search and generation
• Simple and intuitive CLI and Python API
• Access 200,000+ icons from Iconify
• Unlimited icons from direct URLs or local files
• Customize colors, sizes, and backgrounds and adjust border radius
• Gradient color option for icons and backgrounds
• Export to SVG, PNG, or WEBP format

Installation

pip install icon-gen-ai

(Optional) AI features:

pip install icon-gen-ai[ai]

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_ai_icons_on_bg.py - Generate icons on different backgrounds
• generate_judge_icon.py - Generate legal/law icons
• ai_simple_usage.py - Use natural language to search and generate icons
• ai_icon_search.py - Use natural language to search and generate icons with custom style

Development

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

# Install all dependencies (including dev tools)
uv sync
uv sync --extra ai

# Run tests
uv run pytest --cov=src --cov-report=term-missing

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.