π 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,.jpegor.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 1See all your projects at a glance with image counts and status badges. Open an existing one or click + New project.
Vision Model
Step 2EDICO 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 3Set your unique trigger word and the character's fixed traits (hair, eyes, buildβ¦). These are prepended to every caption automatically.
Images
Step 4Drag & drop a folder onto the zone, or click to browse. Preview thumbnails, remove single images, or clear all before continuing.
Categories
Step 5Edit 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 6Watch live progress on a thumbnail grid as each image is captioned. You can cancel, then resume later β finished images are always skipped.
Organizer
Step 7The 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 listin 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:7bor 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
Delia450K2is 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,
backgroundExample:
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, cityscapeNotice: 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 β
/workingnow holds your numbered.png/.txtpairs, ready for your trainer (Kohya, OneTrainer, etc.).
βοΈ MIT License Β© 2026 Gabriel Solis Β· Great datasets make great LoRAs.
