New mascot from a picture
If ANTHROPIC_API_KEY is set, python make.py create <name> --image <path> does steps 1-4 itself; then read the
model sheet and go to step 5. Inside Claude Code without a key, do it by hand:
python make.py new <name> --from-image <path>(lowercase-dash name).python make.py check <name>, then readout/<name>/check/grid.png. Find the mouth centre and both eye centres in the grid's pixel coordinates; sample the skin colour next to the mouth (PILgetpixel).- Edit
mascots/<name>/mascot.py:MOUTH = dict(at=..., width=..., cover=dict(color=<skin>, size=(w, h)))when the picture already has a mouth,EYES = dict(left=..., right=..., size=(rx, ry), lid=<skin>)for blinking. Width is roughly the drawn mouth's width x 1.1. python make.py check <name>again and readmodel_sheet.png: the 9 mouths must sit on the face and fully hide the original mouth. Adjust and repeat until they do.- Voice: ask which provider (macOS
sayis zero setup; ElevenLabs needsELEVENLABS_API_KEYin.env; Voicebox / own recording =VOICE = {"provider": "file"}+--audio). For a new ElevenLabs voice usedesign-voice, let the user listen, thensave-voice. python make.py video <name> --text "...", thenpython make.py sheet <name> <take dir> 0.5 2 4and read the sheet before reporting.
Existing mascot
python make.py video <name> --text "..." (or --script file.txt, or --audio file.wav --text "same words").
More poses or hand-drawn mouths: see mascots/_template/README.md for file names; trigger words live in TRIGGERS.
Fixes
- Mouth too big/small or off-centre:
MOUTH.width/MOUTH.at. - Old mouth showing through: grow
cover.sizeor fixcover.color. - Lip sync feels loose:
bash scripts/install_rhubarb.sh(the fallback is loudness-only), and pass--textwith audio. - Captions wrong words:
pip install openai-whisper.