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
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.
A: Yes! As long as you use a compatible mobile frontend like SillyTavern Mobile, these cards will work perfectly on any device.
