πŸ“˜ EDICO β€” User Guide

Eliz & Delia's Image Captioner and Organizer β€” a step-by-step guide to building a clean, AI-captioned character dataset for LoRA training, entirely in your browser.

EDICO is a local, open-source tool that takes a folder of character images and turns them into a consistent, structured caption dataset. Everything runs on your machine through Ollama β€” your images never leave your computer.

βš™οΈ Before you start

  • Windows with PowerShell 5.1 or 7+.
  • Ollama installed and running (ollama.com/download).
  • A vision model pulled, e.g. ollama pull huihui_ai/qwen3-vl-abliterated:8b-instruct.
  • Images in .png, .jpg, .jpeg or .webp.

πŸš€ Quick start

1. Download the release files (dataset_tool.ps1 + start.bat) from GitHub.

2. Double-click start.bat β€” a terminal appears briefly, then your browser opens EDICO automatically.

3. Keep the terminal window open while you work β€” it's the server. Close it with Ctrl+C when you're done.

The top-right documentation button always links back to this site.

🧭 The 7-step workflow

πŸ‘‹

Welcome

Step 1

See all your projects at a glance with image counts and status badges. Open an existing one or click + New project.

🧠

Vision Model

Step 2

EDICO detects your installed Ollama models and marks vision-capable ones with a [VL] badge. You can also pull a new model right from the field.

πŸͺͺ

Identity

Step 3

Set your unique trigger word and the character's fixed traits (hair, eyes, build…). These are prepended to every caption automatically.

πŸ–ΌοΈ

Images

Step 4

Drag & drop a folder onto the zone, or click to browse. Preview thumbnails, remove single images, or clear all before continuing.

🏷️

Categories

Step 5

Edit the caption vocabulary: add or remove terms per category, reset any category to defaults, and expand Advanced: System Instruction to fine-tune the AI's rules.

⚑

Pipeline

Step 6

Watch live progress on a thumbnail grid as each image is captioned. You can cancel, then resume later β€” finished images are always skipped.

πŸ—‚οΈ

Organizer

Step 7

The final review room: filter, edit, rearrange, add, and manage your finished dataset.

πŸ“‚ Where your files live

Every project gets its own folder, named after your trigger word:

YourTrigger/
β”œβ”€β”€ config.json   # settings, categories, instruction
β”œβ”€β”€ source/        # your originals (never modified)
└── working/       # sequenced copies + .txt captions

πŸ”Ž Pro tip: when a project is open, click Open files next to the step bar to jump straight into the /working folder in Windows Explorer β€” perfect for grabbing the final dataset for your trainer (Kohya, OneTrainer, etc.).

πŸ› οΈ Mastering the Organizer

πŸŽ›οΈ

Filters

Filter by any category β€” pose, expression, framing… Each filter shows live counts, plus an unspec pill (dashed, italic) for images missing that attribute. Toggle Multi-select to combine filters, or switch to single-select to isolate one term.

✏️

Structured editor

Click Edit on any card. See the image and full caption, then pick one term per category in the accordions β€” no raw text editing. Free-text fields handle Clothing and Accessories, and you can even add a brand-new term to a category on the fly.

βž•

Add images

Add an image later: drop it in, describe clothing & accessories, pick terms, and save. EDICO stores the original in source/ and sequences a numbered copy into working/ β€” even if two files share a name.

πŸ”€

Rearrange & Re-sequence

Drag cards to set your preferred order, or use Auto-arrange to sort by up to three priorities (e.g. close-ups first, then front views). Run sequencer renames images and their matching captions to 001…N.

🏷️

Badges on every card

Each thumbnail shows its format and resolution. Green = standard size (512, 768 or 1024 square). Red = non-standard β€” worth a second look. A DUP badge flags near-identical captions that might be duplicate poses.

πŸ”

Lightbox

Click any image for a large preview with badges, arrows to navigate, and quick Edit / Del buttons right there.

🩹 Troubleshooting

  • No models shown? Make sure Ollama is running (ollama list in a terminal).
  • Captions fail or hang? Verify the model is vision-capable and that Ollama is responsive. EDICO retries each image up to 3 times and logs errors to _pipeline_log.txt.
  • Stopped mid-run? Reopen the project β€” EDICO shows "N of M already captioned" and offers Resume.
  • Gallery looks wrong? Hit Reset filters β€” an old filter may be hiding images.
  • Port busy? Close other EDICO instances; it auto-picks the next free port.

πŸ§ͺ EDICO β€” Dataset Recommendations

Practical tips for building a training dataset your LoRA will actually thank you for β€” from image count to vocabulary design.

The quality of your LoRA is decided before training β€” in the images you collect and the captions you write. These recommendations walk through each EDICO step with the numbers and rules of thumb that work.

🧠 Step 2 β€” Use a vision model you trust

  • Pick a model marked [VL] β€” that's EDICO flagging it as vision-capable.
  • Recommended: huihui_ai/qwen3-vl-abliterated:8b-instruct β€” strong detail and instruction-following.
  • Budget hardware? huihui_ai/qwen2.5-vl-abliterated:7b or a 4b variant run faster with slightly less nuance.
  • Consistency beats cleverness β€” whatever you pick, finish the whole dataset with the same model so wording stays uniform.

πŸͺͺ Step 3 β€” Make the trigger word memorable

  • Use a unique, uncommon token β€” avoid real names or single words already common in captions (e.g. "girl"). A fictional tag like Delia450K2 is far easier for the model to treat as one concept.
  • Keep it consistent β€” same spelling, same format, across every image and every caption.
  • Write a rich, fixed base identity β€” hair, eyes, build, skin tone. Because it's prepended automatically, every caption carries the full character description.

πŸ–ΌοΈ Step 4 β€” Curate your images before captioning

  • Aim for 50–200+ good images. For a single character, ~100 is a strong starting point; more helps rare angles or outfits.
  • Prefer square standard resolutions β€” 512Γ—512, 768Γ—768 or 1024Γ—1024. EDICO flags non-standard sizes in red on every card.
  • Seek variety on purpose:
    • poses (standing, sitting, dynamic…)
    • framings (close-up, half body, full body…)
    • gazes, expressions, and camera angles
    • lighting and backgrounds (studio, daylight, indoors…)
  • Keep the face clearly visible in most images β€” that's what your LoRA has to learn hardest.
  • Drop duplicates and near-duplicates before you start. EDICO's DUP badge helps you spot caption twins.
  • Remove watermarks, text overlays, and extreme crops β€” the model will treat them as features of your character.

🏷️ Step 5 β€” Design the vocabulary like a designer

  • Balance categories β€” keep pose, framing, viewpoint, lighting and background terms genuinely distinct so each caption describes one of each.
  • Avoid overlapping terms across categories ("sitting" in Pose and "sitting on chair" elsewhere will confuse matching). EDICO's filter pills make overlaps visible.
  • Keep terms short and consistent β€” "looking at camera" not "gazing toward lens". The AI reproduces whatever you teach it.
  • Clothing & accessories are free-text because outfits are endless β€” but keep the wording style parallel with category terms.
  • Test one small batch first β€” caption 5–10 images, review in the Organizer, then tune the vocabulary before running the full set.

🏷️ The anatomy of a good caption

Goal: a caption that is consistent, complete, and keyword-clean for training:

trigger, fixed identity,
clothing, accessories,
pose, head, gaze,
expression, framing,
viewpoint, lighting,
background

Example:

Delia450K2, woman, adult,
light olive skin, brown eyes,
toned build, short dark hair,
floral top, necklace,
standing, head upright,
looking at camera, smiling,
half body, front view,
soft daylight, cityscape

Notice: every variable attribute appears exactly once.

⚠️ What to avoid

  • Quality fluff β€” "masterpiece", "8k", "photorealistic". These train the LoRA to chase styles, not your character.
  • Articles & full sentences β€” "a woman wearing a jacket" adds noise. Keyword style is cleaner.
  • Emotion guesses β€” describe the visible expression, never inner feelings.
  • Identity drift β€” if the same character's hair changes color between images, your LoRA won't know which one to learn.
  • Mixed languages β€” keep captions in one language throughout.

🧹 Final pass in the Organizer

  • Scan red resolution badges β€” re-export or drop non-standard sizes.
  • Review DUP badges β€” confirm they're intentional variety, not duplicates.
  • Filter by unspec in each category β€” those are images the AI couldn't categorize; fix them by hand in the editor.
  • Rearrange deliberately β€” group close-ups first, or order by outfit β€” then run the sequencer so your final folder is clean and numbered.
  • Grab the folder with the Open files button β€” /working now holds your numbered .png/.txt pairs, ready for your trainer (Kohya, OneTrainer, etc.).

πŸ“š More resources

Other tools   πŸ™ GitHub

βš–οΈ MIT License Β© 2026 Gabriel Solis Β· Great datasets make great LoRAs.

Shopping Cart
Scroll to Top