SD Character Finder
Extension for Stable Diffusion WebUI and Forge
Can't remember the exact tag for that specific character? Want to discover a new art style and completely change the look of your generations? Say no more! 🦸♂️
Your ultimate character encyclopedia and artist style discovery tool directly inside your Stable Diffusion WebUI. Browse 39,006 canonical characters (Danbooru, e621 and AnimaDex) and 19,800+ unique artist styles without leaving your UI. Search characters by name, tag or series, discover art styles with real-time previews, and send character tags and artist signatures straight to txt2img with a single click.
Features 🎯
🔍 Browse Characters
39,006 canonical characters backed by 59,508 source representations (20,016 Danbooru + 3,000 e621 + 36,492 AnimaDex), inside the WebUI with no tab switching
Search by character name, tag or series, with multi-keyword filtering (e.g.
miku vocaloid)Switch source per character: read the Danbooru, e621 or AnimaDex version of the same character without leaving the card, each with its own untouched prompt
Search also matches official aliases, original work titles and Western/common work aliases
Filter by availability: confirmed multi-source characters, reviewed exclusives or source-only candidates
Recent searches and Favorites tabs, saved locally
Offline SQLite database for instant results, with pagination that stays snappy
🎨 Discover Artist Styles
19,800+ unique artist styles (6,024 Danbooru + 4,032 e621 + 15,879 AnimaDex) in a dedicated Artists tab
Dual-preview cards: two side-by-side examples per artist (e.g. Tifa Lockhart and Harry Potter in that style)
One-click apply: click a card, then Add to txt2img to inject
by artist_name(@artist_namefor Anima artists)Favorites for artists, plus separate pagination, thumbnail size and column settings
🖼️ Character Info & Preview
Thumbnails with color-coded source badges in a responsive card grid, on desktop and mobile
Click any card for details and prompt tags, with a large expandable preview
Recently Viewed panel for characters and artists
Expandable Live Danbooru Tags (clothes, eyes, hair and more) as selectable checkboxes by category
Appended tags follow NovelAI-style ordering
🚀 One-Click Prompting
Send to Generate replaces your txt2img prompt and switches to the tab
Add to txt2img appends tags to your existing prompt, with optional smart deduplication
Works for both character tags and artist style tags
⚙️ Configuration & Integrity
Native WebUI settings (Settings → Options → SD Character Finder)
Results per page for Characters and Artists independently, plus thumbnail size, cards per row, deduplication and Danbooru API credentials
The packaged catalogue is verified on every startup, with a one-click verified redownload if it fails
Installation 📦
Open your WebUI and go to the Extensions tab
Click the Install from URL sub-tab
Paste:
https://github.com/eduardoabreu81/sd-character-finderClick Install
Go to the Installed sub-tab and click Apply and restart UI
Compatible with AUTOMATIC1111, Forge, and Forge Classic / Neo.
Quick Start 🚀
Go to the Characters tab in your WebUI
Type a character name or tag (e.g. miku, saber, blue hair), or pick a series from the dropdown (e.g. Arknights)
Click Search, then click a character card to see the preview and tags
Click Send to Generate or Add to txt2img to fill your prompt
🎨 Discovering Artist Styles
Switch to the Artists tab and browse the gallery visually
Click a card to load the artist's tag, then Add to txt2img
Combine character + artist for unique generations!
Documentation: Changelog · v0.7.0 release · GitHub
Description
v0.2.3 — Gradio 3 Backward Compatibility
Fixed an issue causing crashes on Forge Classic due to unsupported js keyword arguments by enforcing _js when invoked under older Gradio runtimes.
v0.2.2 — Forge Classic Startup Fix (Part 2)
Settings Parser Fix — Explicitly mapped
floatconfig values to Gradio Slider components to prevent startup crashes on older or parallel forks (e.g. Forge Classic) where global UI parsing failed during boot.
v0.2.1 — Forge Classic Startup Fix
Settings Parser Fix — Explicitly mapped
floatconfig values to Gradio Slider components to prevent startup crashes on older or parallel forks (e.g. Forge Classic) where global UI parsing failed during boot
FAQ
Comments (14)
Hello there. Have you considered working with the team of Forge Neo to craft the next version? I mean, it would be an awesome upgrade with all your stuff implemented. Cheers 🙌
Hello! Thank you so much for the kind words! 🙌
Honestly, my main intention with my extensions was just to solve my own daily pain points while generating images. I haven't really thought about reaching out for official integrations, as my focus right now is just to keep creating new extensions (or improving existing ones) that can help my workflow and the community's.
I'm really glad to hear you think it has that level of quality, though! Thanks again for the amazing support and the idea. Cheers! 🍻
I get this error after installing (I use Forge Classic):
Exception in thread Thread-8 (webui_worker):
Traceback (most recent call last):
File "C:\Program Files (x86)\Python 3.11.9\Lib\threading.py", line 1045, in bootstrapinner
self.run()
File "C:\Program Files (x86)\Python 3.11.9\Lib\threading.py", line 982, in run
self._target(*self._args, **self._kwargs)
File "L:\AI\sd-webui-forge-classic\webui.py", line 68, in webui_worker
shared.demo = ui.create_ui()
^^^^^^^^^^^^^^
File "L:\AI\sd-webui-forge-classic\modules\ui.py", line 846, in create_ui
settings.create_ui(loadsave, dummy_component)
File "L:\AI\sd-webui-forge-classic\modules\ui_settings.py", line 153, in create_ui
component = create_setting_component(k)
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "L:\AI\sd-webui-forge-classic\modules\ui_settings.py", line 39, in create_setting_component
raise Exception(f'bad options item type: {t} for key {key}')
Exception: bad options item type: <class 'float'> for key sdcf_live_min_freq
Hey! Thanks so much for reporting this. I actually use Forge Neo as my main UI, which handles some system settings a bit differently, so this bug slipped right past me!
I've just pushed an update that completely fixes this startup crash. If you update or reinstall the extension from the repository, it should boot up perfectly fine on your Forge Classic now.
I'll definitely keep a closer eye on cross-compatibility between the different Forge versions in future updates. Let me know if everything is working for you now!
@dhunters Thanks for the quick update. I tried it again, though I got another error:
Exception in thread Thread-8 (webui_worker):
Traceback (most recent call last):
File "C:\Program Files (x86)\Python 3.11.9\Lib\threading.py", line 1045, in bootstrapinner
self.run()
File "C:\Program Files (x86)\Python 3.11.9\Lib\threading.py", line 982, in run
self._target(*self._args, **self._kwargs)
File "L:\AI\sd-webui-forge-classic\webui.py", line 68, in webui_worker
shared.demo = ui.create_ui()
^^^^^^^^^^^^^^
File "L:\AI\sd-webui-forge-classic\modules\ui.py", line 846, in create_ui
settings.create_ui(loadsave, dummy_component)
File "L:\AI\sd-webui-forge-classic\modules\ui_settings.py", line 153, in create_ui
component = create_setting_component(k)
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "L:\AI\sd-webui-forge-classic\modules\ui_settings.py", line 39, in create_setting_component
raise Exception(f'bad options item type: {t} for key {key}')
Exception: bad options item type: <class 'float'> for key sdcf_scraper_rate_limit
@Lopodelas Whoops! Classic 'whack-a-mole' situation! 😂
The UI startup crashed on the very first float variable it found, so it didn't even reach the second one during testing. I've just combed through all the settings and explicitly mapped that specific rate limit variable (and any remaining floats) to Sliders as well.
I will update it here in a new version, but a new git pull should finally clear the runway for you to boot up. Thanks for your patience and for helping me iron this out for the Forge Classic folks!
@dhunters Thanks for your work :D. The webui boots now instead of freezing up, although without the Character Finder, which gave this error:
*** Error executing callback ui_tabs_callback for L:\AI\sd-webui-forge-classic\extensions\sd-character-finder\scripts\wildcard_creator.py
Traceback (most recent call last):
File "L:\AI\sd-webui-forge-classic\modules\script_callbacks.py", line 176, in ui_tabs_callback
res += c.callback() or []
^^^^^^^^^^^^
File "L:\AI\sd-webui-forge-classic\extensions\sd-character-finder\scripts\wildcard_creator.py", line 42, in on_ui_tabs
blocks = build_ui()
^^^^^^^^^^
File "L:\AI\sd-webui-forge-classic\extensions\sd-character-finder\wildcard_creator\ui.py", line 788, in build_ui
buildcharacters_content()
File "L:\AI\sd-webui-forge-classic\extensions\sd-character-finder\wildcard_creator\ui.py", line 509, in buildcharacters_content
btn_char_save_tag.click(
TypeError: EventListenerMethod.__call__() got an unexpected keyword argument 'js'
---
@Lopodelas Done! I've just pushed a new fix (v0.2.3) to adjust the code for Gradio 3 compatibility. I'll make sure to install Forge Classic later this week so I can run some proper local tests on my end too. Huge thanks for all the testing and detailed reports, I really appreciate it!
@dhunters I believe it works now, no errors so far. I initially thought the search was more like browser with previews of those characters before clicking on the name. I had hoped to find interesting characters that way. Would it be possible to set that up?
@Lopodelas I can work on this. ;)
@dhunters Nice, I can't wait :3
@Lopodelas it's on! let me know what you think! ;)
@dhunters Nice, works great and it looks pretty good. Can you add a setting to adjust thumbnail size and amount of thumbnails per row? When clicking "Send to Generate", would it be possible to automatically switch the tab to it? Same with t2i and so on
@Lopodelas I have this feature in another app, I'll try to migrate it to this one. I'll keep you posted!