---
name: anime-consistency-checker
description: >
  Compare anime character images for visual consistency. Built-in profiles for
  Broken Spire characters: Ash, Far-Future Ash, Everly, Éva Moreau, Nova, Violet,
  Lin Weishan, TC-23, Jonas. Use to check character consistency, compare frames,
  audit character sheets, or detect continuity errors.
---

# Anime Consistency Checker

Compare anime character images against references to catch visual inconsistencies.
Built for Broken Spire anime opening frame validation.

---

## Built-in Character Profiles

| Character | Reference | Key Features |
|-----------|-----------|---------------|
| Ash | Ash.png | Blond, messy hair, blue eyes, tribal tattoos, slim athletic |
| Far-Future Ash | Far-Future Ash.png | White hair, red eyes, dark armor, villain |
| Everly | Everly.png | Short dark hair, military uniform, intense |
| Éva Moreau | Éva Moreau.png | Brown hair, lab coat, professional |
| Nova | Nova Human.png | Red flowing hair, fighter, dual form |
| Violet | Violet Devil.png | Purple hair, devil horns, dual form |
| Lin Weishan | Lin Weishan.png | Black long hair, fighter |
| TC-23 | TC-23.png | Mechanical augments, cybernetic eyes |
| Jonas | Jonas.png | Large, scarred, warm smile |

---

## Quick Check Command

```bash
cd /mnt/c/Users/fbmor/broken-spire-comparison
python3 automated_consistency_workflow.py --analyze
```

## Run Iterative Correction (auto-regenerate until 85%)

```bash
cd /mnt/c/Users/fbmor/broken-spire-comparison
python3 automated_consistency_workflow.py --iterative
```

**Note:** RunPod pod must be running for regeneration. Start with:
```bash
python3 /mnt/c/Users/fbmor/runpod_anime_automation.py --start
```

---

## Manual Comparison Checklist

For each generated frame, verify against reference:

| Dimension | Check |
|-----------|-------|
| Proportions | Head-to-body ratio correct |
| Face & Features | Eye shape/color, face shape match |
| Hair | Color, length, style correct |
| Clothing | Garments, colors, patterns match |
| Accessories | All items present, correct position |
| Color Palette | Overall colors match reference |
| Art Style | Shading method consistent |

**Status:** ✅ = Good | ⚠️ = Minor issue | ❌ = Needs regeneration

---

## Frame to Reference Mapping

| Generated Frame | Character(s) | Reference(s) |
|----------------|--------------|---------------|
| 02_ash_birth | Ash | Ash.png |
| 03_far_future_ash_evil | Far-Future Ash | Far-Future Ash.png |
| 05_everly_soldier | Everly | Everly.png |
| 06_eva_doctor | Éva Moreau | Éva Moreau.png |
| 07_nova_warrior | Nova | Nova Human.png |
| 08_violet_devil | Violet | Violet Devil.png |
| 09_lin_weishan | Lin Weishan | Lin Weishan.png |
| 10_tc23_esper | TC-23 | TC-23.png |
| 11_jonas_ghost | Jonas | Jonas.png |
| 13_ash_everly_tension | Ash + Everly | Ash.png, Everly.png |
| 14_ash_eva_medical | Ash + Éva | Ash.png, Éva Moreau.png |
| 15_ash_nova_war | Ash + Nova | Ash.png, Nova Human.png |
| 17_all_characters | All 4 | All references |

---

## Fix Inconsistencies with IP-Adapter

1. Open: https://n7ecweltbele73-8188.proxy.runpod.net
2. Load: sd_xl_anime_final.safetensors
3. Add: IPAdapter Unified Loader → IPAdapter Advanced
4. Load: Reference image
5. Generate: Same prompt with IP-Adapter
6. Replace: Failing frame

---

## File Locations

- **RunPod Network Volume (persistent)**: `/workspace/runpod-slim/ComfyUI/output/`
- **Local Backup**: `/mnt/c/Users/fbmor/broken-spire-comparison/generated/`
- References: `/mnt/c/Users/fbmor/broken-spire-comparison/references/`

## Automation Script

The automated workflow uses:
- NAS output path for generated images
- Local references for consistency comparison
- Detailed inconsistency reports with specific comments
- Iterative correction loop until 85% consistency threshold