keryx avatar add¶
Description¶
Register an avatar under <name> from <image>. On first registration keryx runs
a one-off vision analysis of the image (via the image provider) to capture a
reusable profile — likeness (physical description, style-independent),
style (the image's own art style), and palette — and writes
avatars.<name> to config. The image path becomes the avatar's ref (keryx holds
no asset). The captured profile is a starting point; edit it in config or re-run.
Usage¶
keryx avatar add matt assets/images/avatar-mc.webp
# → registers `matt`; drop into a reel with `cards gen --avatar matt`
Requires GEMINI_API_KEY (the analysis call). The captured likeness is kept
free of style so the avatar can be restyled into any theme; style is the
avatar's own look, used by default.