A simple local web app for downloading character images from multiple sources.

## Sources

**NSFW**
- Danbooru (no rating filter when NSFW is enabled)
- Konachan.com
- Yande.re

**SFW**
- Konachan.net
- Wallhaven.cc
- Zerochan.net
- Safebooru.org
- Civitai.com

## Features

- Character name + Series fields (both are used by every source)
- Extra Danbooru tags
- Allow NSFW toggle
- Higher resolution filter
- Optional AI NSFW filter
- In-browser gallery with preview and delete
- Saves images into a `downloads` folder next to the app

## Requirements

Install the dependencies from `requirements.txt`:

```
pip install -r requirements.txt
```

Or install them manually:

```
pip install requests Pillow ddgs transformers torch
```

**Note:** `transformers` and `torch` are only needed if you use the Extra AI NSFW filter. The app works without them if you leave that option unchecked.

## How to Run

1. Download `app.py` and `requirements.txt`
2. Install the requirements above
3. Double-click `app.py` or run:
   ```
   python app.py
   ```
4. Your browser will open at `http://127.0.0.1:8765`
5. Enter a character name and series, select sources, and click Download

## Notes

- Images are saved in a `downloads` folder next to `app.py`
- Free Danbooru accounts are limited to 2 tags total
- Some sources (Zerochan, Civitai) use web search as a fallback
- The AI NSFW filter downloads a model on first use (~350 MB) and is optional

## Credits

Built for easy character dataset collection. Free to use and share.