Metadata-Version: 2.4
Name: undraw-py
Version: 1.0.16
Summary: A minimalist CLI for unDraw illustrations (Python port)
Project-URL: Homepage, https://github.com/stefdevscore/undraw-cli
Project-URL: Repository, https://github.com/stefdevscore/undraw-cli
Author-email: azk <you@example.com>
License: Unlicense
Keywords: agentic-ai,cli,illustrations,svg,undraw
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: click>=8.1.7
Requires-Dist: rich>=13.7.1
Description-Content-Type: text/markdown

# unDraw CLI (Python) 🎭

> A high-performance, ultra-minimalist Python CLI to search, customize, and download the entire [unDraw](https://undraw.co) library (1,650+ illustrations).

This is the Python port of the original [undraw-cli](https://github.com/stefdevscore/undraw-cli).

---

## ✨ Features

- **🎯 Zero-Dependency Networking**: Built with native `urllib.request`—no external network libraries.
- **🚀 Consolidated Search**: Search 1,650+ illustrations by keyword or browse by page.
- **🎨 On-the-Fly Customization**: Automatically replace the default unDraw color with your brand's hex code.
- **📦 Ultra-Tiny footprint**: Modern Python packaging with `hatchling`.
- **🤖 Agentic Ready**: Optimized for AI developers who need structured, fast access to high-quality SVG assets.

---

## 🚀 Quick Start

### Installation

```bash
pip install undraw-py
```

### Usage

1. **List or Search illustrations**:
   ```bash
   undraw list           # Browse by page (20 per page)
   undraw list "space"   # Search for "space"
   undraw list --page 2  # Go to page 2
   ```

2. **Download with a custom color**:
   ```bash
   undraw download astronomy_ied1 --color #34d399
   ```

3. **Sync the library**:
   ```bash
   undraw sync
   ```

---

## 🛠️ Commands

- `undraw list [query]`: Paginated browsing or keyword search.
- `undraw download <id>`: Fetch the SVG and apply a custom hex color.
- `undraw sync`: Crawls unDraw.co and updates the embedded source metadata.

---

## 🙏 Credits & Attribution

### unDraw Illustrations
The illustrations are provided by **Katerina Limpitsouni** at [unDraw.co](https://undraw.co).  

*Note: This is an unofficial community project and is not affiliated with unDraw.co.*

---

## ⚖️ License
MIT
