Setup guide
Your files: a 5-second loop (WebM and MP4), a square PNG and a round PNG. Here is exactly where each one works. Checked against each platform's official docs on 2 November 2026; ChatGPT pets added 3 November 2026.
ChatGPT and Dots Moves
- Every Liveling comes with a pet file: one moving sprite sheet (1536 × 1872, transparent) made for ChatGPT pets.
- On chatgpt.com: Settings, Pets, then Upload pet: type its name and pick the file. It becomes your pet right away. It moves in ChatGPT on the web and in the desktop app, which can float it over your other windows.
- For your Dot: tap your Dot's picture (Customize your dot), pick your Liveling under Pets, then Save.
- Codex: save the pet file as
~/.codex/pets/<name>/spritesheet.webpnext to itspet.json. Your order page has a one-line command for this. - Add the soul (below) and it talks like your Liveling too.
Your website or app Moves
- Use the loop as a muted, looping video with the PNG as its poster. Phones need
mutedandplaysinlineto autoplay. - Easiest: hand the install skill to your coding agent (Claude Code, Codex or similar) and say "install my Liveling".
Your own agent or chat UI Moves
- If you built the interface (OpenAI ChatKit with your own front end, the OpenAI Agents SDK, the Claude Agent SDK, or anything else), you control the screen, so the loop can play next to every message.
- The install skill covers this too, including calm "thinking" and "idle" states.
Custom GPT Picture
- Open your GPT in the editor, go to Configure, and upload the round or square PNG as its picture.
Grok bot Picture
- Click the bot's name, click its picture, choose Upload, then Set avatar. Files must be under 25 MB.
Discord bot Picture
- In the Discord Developer Portal, open your app and upload the PNG as the bot's avatar.
Slack app Picture
- In your app's settings: Basic Information, then Display Information. Upload the square PNG (Slack takes 512 to 2000 px).
Telegram bot Picture
- In BotFather, send
/setuserpic, choose your bot and send the square PNG.
ElevenLabs agent widget Picture
- In the widget settings, set the Avatar to an image link pointing at your PNG.
Give it a soul Any AI that takes instructions
Every paid Liveling comes with SOUL.md: its personality, voice, moods and how it grows as you talk. The picture gives your AI a face; the soul gives it a way of speaking.
Easiest: on your order page, tap your AI (ChatGPT, Meta Muse, Claude or any other). The page copies a ready message with the soul inside and opens the app; paste it and send. Your AI adds the personality and keeps your own settings. The steps below are for people who prefer the file.
- Any AI with an instructions box (custom GPT, Gemini Gem, Copilot Studio agent, your own agent's system prompt): paste SOUL.md into the instructions. Your own instructions still come first.
- Claude: upload
liveling-<name>.zipunder Customize, then Skills. Or paste SOUL.md into a Project's instructions. Claude Code: copy the folder into~/.claude/skills/. - ChatGPT skills (Business, Enterprise, Healthcare and Edu plans only): Skills, then Create, then Upload from your computer, and pick the
liveling-<name>folder. - Coding agents and file-based agents (Codex, Cursor, OpenClaw): put SOUL.md in the project and add one line to AGENTS.md: "Speak as described in SOUL.md."
- Meta Muse: on your order page tap Meta Muse, paste the ready message into Muse and send. Muse adds the character to its own SOUL.md and keeps what is there. Don't replace Muse's whole SOUL.md, or the whole assistant changes.
Not possible today: Meta AI Studio (closed to new characters since Aug 2026). On apps without memory, say "grow" to move it to its next stage. Checked against official pages on 2026-11-02.
Not supported today
- Claude, Gemini and Meta AI apps don't offer a custom avatar or pet for your AI. This page will say so if that changes.
Livelings by Phantom Firm · Licence