1. Input Source (JSON or YAML)

2. Select Your Character Portrait

Upload the PNG image you want to use as the card's face. If you don't provide one, we'll use a standard template.

Technical Details of the TavernAI V2 Spec

Our creator tool doesn't just "rename" your file. It performs a multi-step binary injection process:

1. tEXt vs zTXt Chunks

We write character data into the tEXt chunk of the PNG file using the chara key. The card is written with a standard tEXt chunk plus a compressed zTXt copy of the same data.

2. UTF-8 Safe Base64 Encoding

To prevent special symbols or non-English characters from corrupting the card, we encode the entire JSON payload into Base64. This is the requirement for 100% compatibility with the SillyTavern and TavernAI ecosystems.

3. Metadata Fields

CharacterAI fields are mapped into the V2 spec's nested data object: the name, description and greeting (first_mes) carry over directly, and the CharacterAI definition becomes the personality.

Compatible Frontends

Any card created with this tool is fully compliant with the following software:

  • SillyTavern: Full support for expressions, avatars, and lorebooks.
  • TavernAI: The original desktop roleplay interface.
  • Faraday.dev: High-performance local AI application.
  • Agnai: Web-based character management and chat.

FAQ: Creating character cards

Q: Can I use a JPG image?

A: No. Character cards require the PNG format because it supports custom metadata chunks without losing quality. If you have a JPG, convert it to a PNG first before using this tool.

Q: Will this card work on my mobile phone?

A: Yes! As long as you use a compatible mobile frontend like SillyTavern Mobile, these cards will work perfectly on any device.