$git clone https://github.com/EddieTYP/image-prompt-libraryImage Prompt Library is a local-first visual library for generated images and the prompts behind them. Save useful image results, preserve the prompt and source metadata, organize references into collections and tags, and find them again as an image-first catalogue.
| 1 | # Image Prompt Library |
| 2 | |
| 3 | [](https://github.com/EddieTYP/image-prompt-library/actions/workflows/ci.yml) |
| 4 | [](https://github.com/EddieTYP/image-prompt-library/actions/workflows/pages.yml) |
| 5 | [](https://github.com/EddieTYP/image-prompt-library/releases/latest) |
| 6 | [](LICENSE) |
| 7 | |
| 8 | <p align="center"> |
| 9 | <strong>Language:</strong> |
| 10 | <strong>English</strong> | |
| 11 | <a href="README_zh-TW.md">繁體中文</a> | |
| 12 | <a href="README_zh-CN.md">简体中文</a> |
| 13 | </p> |
| 14 | |
| 15 | **Image Prompt Library** is a local-first visual library for generated images and the prompts behind them. Save useful image results, preserve the prompt and source metadata, organize references into collections and tags, and find them again as an image-first catalogue. |
| 16 | |
| 17 | Your private library stays on your machine: local SQLite, local image files, no hosted database, no built-in cloud sync, and no account required. |
| 18 | |
| 19 | |
| 20 | ## Introduction |
| 21 | |
| 22 | Image Prompt Library is built for the moment when image-generation prompts become reusable knowledge rather than one-off chat messages. |
| 23 | |
| 24 | **Browse the read-only online demo:** <https://eddietyp.github.io/image-prompt-library/> |
| 25 | |
| 26 | The public demo is a browsable catalogue of **533 prompt/image references** gathered from two generous upstream galleries: [`wuyoscar/gpt_image_2_skill`](https://github.com/wuyoscar/gpt_image_2_skill) (**CC BY 4.0**) and [`freestylefly/awesome-gpt-image-2`](https://github.com/freestylefly/awesome-gpt-image-2) (**MIT**). It covers UI and interface design, posters and typography, product and e-commerce imagery, charts and infographics, technical diagrams, photography, character portraits, architecture, storytelling scenes, and illustration styles. Each reference is shown as an image-first card, with English, Traditional Chinese, and Simplified Chinese prompt variants where available. |
| 27 | |
| 28 | <p align="center"> |
| 29 | <img src="docs/assets/screenshots/public-demo-v0.6-533-references.png" alt="Image Prompt Library public demo showing 533 prompt references" width="100%" /> |
| 30 | </p> |
| 31 | |
| 32 | Use the online demo as a visual prompt catalogue: search for ideas, inspect prompt structure, copy public sample prompts, and compare how different prompt styles map to different image outputs. The GitHub Pages demo is intentionally static and read-only: Add/Edit, private library management, and image generation are local-install features. |
| 33 | |
| 34 | If you want to manage your own private prompt/image library, install the app locally. Local installs let you add and edit your own images and prompts, organize them into collections and tags, search them later, and optionally generate new images through ChatGPT / Codex OAuth while keeping your SQLite database and image files on your own computer. |
| 35 | |
| 36 | Current stable release: [GitHub Latest](https://github.com/EddieTYP/image-prompt-library/releases/latest). It includes native Windows installation, structured search and sorting, batch reference management, cleanup tools, versioned install/update/rollback, a calmer first-run experience, and hardened OAuth session recovery for optional local generation. |
| 37 | |
| 38 | ## Quick start |
| 39 | |
| 40 | ### Windows (v0.8.0+) |
| 41 | |
| 42 | Native Windows support begins with [`v0.8.0`](https://github.com/EddieTYP/image-prompt-library/releases/tag/v0.8.0). Windows 10/11, PowerShell 5.1+, and **Python 3.10+** are required; the installer does not install Python. |
| 43 | |
| 44 | ```powershell |
| 45 | irm https://raw.githubusercontent.com/EddieTYP/image-prompt-library/main/scripts/install.ps1 | iex |
| 46 | ``` |
| 47 | |
| 48 | A successful install starts the app in the background and opens your browser. Stop it with `image-prompt-library stop`; see the [installation guide](docs/INSTALLATION.md) for updates, rollback, diagnostics, private-data |