Skip to content

Feature Tag Autocompletion

eduardoabreu81 edited this page Jul 30, 2026 · 2 revisions

Tag Autocompletion

The autocompletion engine inherited from DominikDoom's a1111-sd-webui-tagcomplete (TAC), with Neo-specific performance and UX work layered on top (marked ⭐).

Core

  • Instant suggestions as you type, sourced from Danbooru, e621, or a merged list — see Tag Lists for the available files and switching between them
  • Keyboard navigation — arrow keys, Tab, Enter, Escape, all remappable
  • Tag color coding by category, with post count shown for relevance
  • Alias and translation search — find a tag by an alternate name or its translated term
  • Wildcards — __ triggers autocomplete with nested folders and YAML (UMI) support
  • Chants — <c: triggers prompt-preset completion for longer phrase templates

Neo additions ⭐

  • Indexed search — a built-in prefix index makes filtering near-instant even on very large tag lists (100k+ entries)
  • Frequency sorting — tags you actually use climb to the top of suggestions over time
  • Multi-word tag search — typing any word inside a multi-word tag matches it, e.g. towards finds walking_towards_viewer
  • Artist completion via @ — type @ to narrow suggestions to Artist tags only, and get Anima's @artist syntax back on insertion (details below)
  • Smooth on mobile — typing and deleting stay responsive on phones/tablets, where the original extension could stutter on large tag lists
  • Status indicator — a toolbar dot shows loading (orange), ready (green), error (red), or disabled (gray), so a broken tag file doesn't fail silently

Artist completion via @

Typing @ turns the suggestion list into an artist-only search, which is how Anima-family checkpoints expect artist styles to be written (@artist_name).

Status: off by default. Enable Show Artist tags when typing @ in Settings → Prompt Studio Neo and click Apply settings — no UI reload needed, the autocompletion engine re-reads its config when settings are applied.

Important

If nothing happens when you type @, this option is the first thing to check — the feature is disabled out of the box.

Files: javascript/ext_artist_tags.js (trigger + search) · javascript/tagAutocomplete.js (insertion).

How the search works

@ plus anything up to the next comma or space becomes the search term, and results are filtered to category 1 of whichever tag list is loaded:

  • Substring match, not just prefix — @ebi finds ebifurya and ebifurai_kakigwa
  • Use underscores, not spaces — @sunset_beach finds hammer_(sunset_beach); a space ends the search term, so @sunset beach finds nothing
  • Matches aliases too when Search by alias is on — @aenobas finds hammer_(sunset_beach)
  • * and ? work as wildcards inside the term — @eb*ya finds ebifurya and yoi_naosuke

The @ you typed is kept when the tag is inserted, so @ebi + ebifurya gives @ebifurya. That happens on its own, without needing either prefix option below.

Interaction with the prefix options

Three options touch the @, and they cover different situations:

Option Default What it's for
tac_artistAtTrigger Off Makes @ search artists. The typed @ is preserved on insertion.
tac_artistInsertAt Off Prefixes @ onto every inserted Artist tag, including ones completed normally without typing @.
tac_animaArtistPrefix Off Same, but only when the loaded checkpoint is detected as Anima-family. Needs a danbooru* tag list. Shares checkpoint detection with Quality Presets and the Live Tag Colorizer's artist-marker coloring.

Use the first alone if you want @ on demand. Add one of the other two if you want artists prefixed even when you didn't type @.

Tag list support

Category 1 means "artist" in the Danbooru and e621 lists, but not in every list:

Tag list Artist tags in category 1
danbooru.csv 59,201
danbooru_2025.csv 82,133
danbooru_e621_merged.csv 59,201
e621.csv 28,287
derpibooru.csv none — category 1 there is generation/series (g4, equestria_girls), so @ lists those instead

Performance note

Typing a bare @ with no letters after it builds the entire artist set — around 59k entries on danbooru.csv — and sorts it by name, which costs roughly 100ms plus a frequency-database lookup before the list appears. One or two characters after the @ cuts that to a few hundred results and it's instant again. This is a deliberate trade-off: artist lookup is rare compared to normal tag typing, so the simple "no minimum length" behavior was kept.

Clone this wiki locally