examples/README.md

Example matchup photos

Drop fighter photos here and they appear automatically as one-click "Try a celebrity matchup" examples on the Tale of the Tape tab. A matchup only shows up once both of its photos exist, so missing files are simply skipped.

Filenames the app looks for

Any of .jpg / .jpeg / .png / .webp:

Matchup	Fighter A file	Fighter B file
Clem Delangue vs. Sam Altman	clem.jpg	altman.jpg
Britney vs. Eminem	britney.jpg	eminem.jpg
Keanu Reeves vs. Scarlett Johansson	keanu.jpg	scarlett.jpg

(The display names + arena are pre-filled by the app — see EXAMPLE_MATCHUPS in ui/app.py. To add a new matchup, add a row there and drop in two photos.)

Photo tips

• Roughly square, face/head-and-shoulders, front-facing, ~512px+.
• A clear, well-lit single face gives the best clay caricature.

⚠️ Licensing — please read

These photos get committed to a public Hugging Face Space, so use images you have the right to redistribute:

• Wikimedia Commons is the easiest source — most of these public figures have CC BY / CC BY-SA or public-domain portraits. Download from there and keep the attribution.
• Avoid press/agency/paparazzi shots (Getty, etc.) — those are copyrighted and not yours to redistribute.
• The app's on-screen "parody / AI caricature" disclaimer covers the generated output, not redistribution of a copyrighted source photo. Source matters.

If in doubt, use a CC-licensed Wikimedia Commons portrait (and note the credit).