Picta – Python Icon Library

Picta is a Python-first, dependency-free icon library inspired by Lucide Icons. It allows Python developers to easily use SVG icons in web apps, dashboards, or any Python project that can render HTML.

---

🌟 Features

• 100+ most used icons included (SVG files bundled).
• Zero external dependencies — works on any OS with Python ≥ 3.8.
• Dynamic icon listing via list_icons() to discover all available icons.
• Direct SVG output via icon() for web, Flask, Streamlit, Dash, or Jupyter notebooks.
• Clean, easy-to-use Python API.

---

📦 Installation

Install via pip:

pip install picta

Or download the latest release manually:

---

⚡ Quick Start

Importing icons

from picta import icon, list_icons

# Get an SVG string for a single icon
svg_str = icon("user", size=32, color="blue")
print(svg_str)

# List all available icons
all_icons = list_icons()
print(all_icons)

---

🔹 Using in a web app (Flask)

pip install flask
python index.py

Open your browser at http://127.0.0.1:5000 to see the icons.

---

💻 Demo

• Header explaining Picta and its purpose
• Install instructions with pip command
• Grid of icons showing icon + name
• Footer with “Contribute on GitHub” button and credit to Lucide Icons

---

🔧 Usage Examples

Getting a single icon

from picta import icon

user_icon = icon("user", size=48, color="#1e40af")

Displaying multiple icons dynamically

from picta import icon, list_icons

for name in list_icons()[:10]:
    print(icon(name, size=32))

---

🤝 Contributing

Picta is open-source. Contributions are welcome!

• Submit bug reports or feature requests via GitHub Issues
• Fork the repository and submit pull requests
• Help us add more icons or improve documentation

---

📄 License

Picta is released under the MIT License.
Icons are inspired by Lucide Icons and follow their usage rules.