OpenAvatar

Make your own avatar

Describe a character in a sentence and let AI build it. An avatar is plain data, so an AI model can write one, and the OpenAvatar skill shows an agent how to check what it made.

With an AI agent

Agents that load skills, such as Claude Code or Codex, can use the OpenAvatar skill. Add the openavatar skill and its reference to your agent's skills, or give the agent this address:

https://openavatar.enconvo.com/skill/SKILL.md

Then ask for the character you want, in your own words: what it is, its colors, what it wears, how it behaves. The agent works in a loop until the picture matches.

  1. Decides the silhouette, colors, material, face and parts.
  2. Writes the .openavatar file.
  3. Checks it with openavatar validate --strict.
  4. Draws a contact sheet and looks at it.
  5. Fixes what doesn't match and checks again.
A contact sheet of Matcha: front, three-quarter, side and back views, then happy, surprised, listening, thinking, speaking, sleeping, coding and waving.
The contact sheet an agent checks, here for Matcha.

In Enconvo

Open Settings, then Avatar, and choose Create. Under Describe it, say what you'd like and pick one of three drafts to fine-tune. Avatars from this gallery open there too, with Open in Enconvo on each avatar's page.

By hand

The openavatar command starts a valid file, checks it, draws it and installs it. It needs Node.js and Chrome, Edge or Chromium.

npx @openavatar/cli new "My avatar" --rig blob -o my-avatar.openavatar
npx @openavatar/cli validate --strict my-avatar.openavatar
npx @openavatar/cli render my-avatar.openavatar --sheet -o sheet.png
npx @openavatar/cli install my-avatar.openavatar

install puts it in ~/.openavatar/avatars/, where every OpenAvatar app on the computer finds it. The spec describes every member of the file.

Share it

An avatar is one file, so it works wherever you send it. To put it in this gallery, add it here.