Metadata-Version: 2.4
Name: aiimgprompt-tools
Version: 0.1.0
Summary: Tiny helpers for turning plain text into cleaner AI image prompts, plus a free browser prompt library.
Author: AI Image Prompt Lab
License: MIT
Project-URL: Homepage, https://aiimgprompt.com/
Project-URL: Free Prompt Library, https://aiimgprompt.com/library/
Project-URL: Text to Image Tool, https://aiimgprompt.com/text-to-image/
Project-URL: Image to Prompt Tool, https://aiimgprompt.com/image-to-prompt/
Keywords: ai,image,prompt,text-to-image,prompt-engineering
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# aiimgprompt-tools

Tiny, dependency-free helpers for cleaning up and shaping AI image prompts —
the boring string work you do before you paste a prompt into a generator.

Written to back the free browser tools at **[AI Image Prompt Lab](https://aiimgprompt.com/)**,
where you can also browse a **[free prompt library](https://aiimgprompt.com/library/)**
without installing anything.

## What's inside

```python
from aiimgprompt_tools import tidy, add_style, as_negative

tidy("  a  red   fox ,,, on a rock ")
# 'a red fox, on a rock'

add_style("a red fox on a rock", "cinematic photo, 35mm, soft light")
# 'a red fox on a rock, cinematic photo, 35mm, soft light'

as_negative("blurry, extra fingers")
# 'blurry, extra fingers'  (deduped, lowercased, trimmed)
```

- `tidy(prompt)` — collapse stray whitespace and duplicate separators.
- `add_style(prompt, style)` — append a style tail without duplicating it.
- `as_negative(prompt)` — normalise a negative-prompt list.

## Why so small?

Most prompt problems are punctuation problems. You do not need a framework to
fix a comma. If you want the same thing with a UI (and no install), the
browser versions live here:

- [Text to image prompt builder](https://aiimgprompt.com/text-to-image/)
- [Image to prompt describer](https://aiimgprompt.com/image-to-prompt/)

## Install

```
pip install aiimgprompt-tools
```

MIT licensed.
