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. For larger cards, we support zTXt compression, ensuring that your card remains a small, portable file even with 30,000 characters of definition text.

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 Normalization

If you are converting from CharacterAI, we automatically re-map your fields into the V2 spec's nested data object, ensuring that name, description, personality, scenario, and mes_example are all in their proper places.

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.