How to Import a Character Card PNG (chub.ai, pygmalion.chat, SillyTavern)
Import a character card from chub.ai, pygmalion.chat or a PNG link in under a minute, then give it a face, expressions and a voice. Step by step.
Yantra Team5 min read
On this page
A character card looks like an ordinary picture. Inside the PNG is the whole character: name, personality, scenario, greeting, example dialogue and sometimes a lorebook. An image viewer shows the portrait. A card reader brings the character to life.
This guide imports a card into Yantra Characters in under a minute, then turns it into much more than a chat.
Import in four steps
- Open Yantra Characters and click Create, then Character.
- Switch to the Import tab.
- Paste a link into From a URL. Any of these work:
- A chub.ai character page, like
https://chub.ai/characters/creator/project - A pygmalion.chat character page
- A direct link to a card PNG or JSON
- A chub.ai character page, like
- Click Import.
The card opens in the editor with every field filled in. Click Save to library and then Chat. The character greets you with the card's own opening line.
Free accounts get 500 credits a day, which is plenty for an import and a long first conversation.
Give it a face that stays the same
Most downloaded cards come with one portrait. Before you save, the panel on the right can generate more art:
- Generate portrait or Repaint portrait.
- Expression sprites: a set of faces for the character's moods.
- Scene art: a background for where the story is set.
Pick the art mode above the buttons. Once the character has a portrait, the face-consistent mode is the default: it edits the character's own portrait instead of starting fresh, so every sprite is clearly the same person. Prompt-only generators drift into six slightly different faces. This mode is how you avoid that.
Tidy up the card
Imported cards are often good ideas with rough edges. The editor groups every field into four tabs, so nothing is buried in a long scroll:
- Identity: name, tags, tagline, categories, rating, art style and the conversation model the character runs on.
- Story: description, scenario, the greeting and every alternate greeting, with the card's lorebook entries listed underneath.
- Personality: temperament, example dialogue that teaches the voice, and up to three conversation starters shown as one-tap openers in chat.
- Advanced: system prompt, post-history instructions and creator notes.
Edits save straight onto the card, so an export later carries your fixes.
Make the chat feel right
Open the chat and the settings panel beside it has the controls that matter for roleplay:
- Writing style: six styles, from fast and direct to slow and literary. Try a few on the same character; the difference is big.
- Model: 21 lanes in Free, Premium and Flagship tiers. Your choice is remembered for this character.
- Persona: add your name and a line about who you are. The card's
{{user}}becomes you, greeting included. - Reply length: short, medium or long.
- Voice: choose who reads replies aloud.
In the chat itself, regenerate a reply and page through the takes with the arrows, or continue a reply that stopped early.
Do more with the character
An imported card is a starting point. From the Create menu:
- Voice: design how the character sounds, from pace and pitch to accent and style. The voice is saved on the card.
- Scene: write a new setting with this character in the cast and play it in chat. The card is untouched, so the original story still works.
- Comics: write a short panel script, then draw it with the same face in every panel.
- Streams: plan a short video series with the character as host, narrated in their voice.
- Podcast: record an interview episode with the character as the guest. Base it on a chat you already had.
Everything you make collects in Productions.
Share it, or take it with you
Open the character's Publish & Export tab.
- Publish to Discover: share your improved version with the community. A moderator reviews it, then it appears in everyone's Discover, where people can chat and leave comments.
- Export: download V2 JSON, V3 JSON, or a card PNG that carries both the
charaandccv3data, so it opens in SillyTavern-family apps too. - Text: chat with the character from your phone's Messages app over iMessage or SMS. Available for general-rated characters.
What is inside a character card PNG
Useful when a card refuses to load.
A card is a normal PNG with a text chunk attached. The chunk holds base64-encoded JSON. Image editors ignore it, which is why the picture still opens anywhere.
| Spec | Chunk name | What it adds |
|---|---|---|
| Card V1 | chara |
The original fields only |
| Card V2 | chara |
System prompt, alternate greetings, creator notes, an embedded lorebook |
| Card V3 | ccv3 |
Assets such as expressions, scenes and audio, plus richer lorebook options |
The core fields are the same in every version:
- name: what the character is called.
- description: who they are, usually the longest field.
- personality: a short summary of temperament.
- scenario: where the conversation starts.
- first_mes: the greeting.
- mes_example: sample dialogue that teaches the voice.
Yantra exports carry both chunks, so a card made or improved here opens in apps that read either version.
Why a card fails to import
- It was re-saved. Many chat apps, image editors and social sites strip text chunks when they compress an image. The picture survives, the character does not. Use the card's original page link, not a reposted copy.
- It was converted. A card saved as JPG or WebP loses its chunk. Cards must stay PNG.
- The link is a web page, not the file. For sites other than chub.ai and pygmalion.chat, right-click the card image and copy the image address, so the link points at the PNG itself.
No card yet? Write one
On the Write one tab, describe the character in a sentence. A want, a flaw and a situation give the studio the most to work with:
A gruff but kind lighthouse keeper on a storm-battered coast who collects messages found in bottles and knows more about the wrecks than he admits.
The studio writes the full card, with an optional lorebook of 4 to 8 world entries, up to six alternate greetings, and any of 12 languages. Or browse Discover for characters other people already published.
FAQ
Is importing a character card free? Yes. Import and chat run on the free daily credits. Art, voice and video use more credits per request.
Which sites can I import from? chub.ai and pygmalion.chat character pages, plus a direct link to any card PNG or JSON file.
Will new art match the original portrait? Use the face-consistent art mode, the default once a portrait exists. It edits the character's own portrait, so expressions and scenes keep the same face.
Does the lorebook come along? Yes. Lorebooks embedded in V2 and V3 cards import with the card, and the entries are listed on the editor's Story tab.
Can I publish a card I imported? You can publish characters in your library from the Publish & Export tab. Respect the original creator's terms, and credit them in the creator notes.
Can I use my characters on my phone? Yes. Characters is in the Yantra app for iPhone and iPad, your library syncs when you are signed in, and general-rated characters can chat by text message.
Import your first card
Open Yantra Characters, choose Create, then Import, and paste a link.