llms.txt
# Masko
> Create mascots for your product and bring them to life. Masko includes a web creation studio, a REST API, a Mac desktop companion, a mascot marketplace and Masko Life.
Use Studio or the REST API to generate assets. Use exported files or hosted URLs in your own product, and connect its events to authored mascot behavior. Agent integrations, desktop notifications and the Mac runtime belong to Masko for Mac. Masko Life is the companion you raise and care for.
## What you can do with Masko
Use cases by where the mascot lives. "Works today" means Masko makes it end to end. "You assemble it" means Masko makes the mascot, its clips and voice, and your own code joins them. Each use case links to its tutorial when one exists, otherwise to the most relevant guide. Overview with the results playing: https://masko.ai/docs/use-cases
### Mobile app
- Add a coach that shows every exercise (works today): One animation per exercise, plus cheers between sets. Guide: https://masko.ai/docs/generate/animations
- Show a mascot while your AI is thinking (works today): Thinking loops for long answers, then a small celebration. Tutorial: https://masko.ai/docs/tutorials/ai-loading-mascot
- Guide your onboarding with a talking mascot (works today): One talking clip per step, in your mascot’s own voice. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Celebrate streaks and progress (works today): Clips for streaks, levels and finished lessons. Guide: https://masko.ai/docs/generate/animations
- Grow a character that evolves with your users (works today): A state machine that hatches, grows and roars as they progress. Guide: https://masko.ai/docs/use-cases/evolving-character
- Make a focus timer where the mascot falls if you leave (works today): It slips when you leave the app and falls after 10 seconds. Guide: https://masko.ai/docs/use-cases/focus-timer
- Build a focus or Pomodoro app with a little buddy (works today): A focus loop, a break loop and a nudge when time is up. Guide: https://masko.ai/docs/generate/animations
- Make a kids’ app with a character that talks to them (works today): A character that talks to kids in their language. Guide: https://masko.ai/docs/generate/talking
- Put a mascot on empty screens and errors (works today): Poses and loops that make an empty list feel less cold. Guide: https://masko.ai/docs/generate/images
- Use your mascot in your app icon and App Store screenshots (works today): An app icon and poses, ready for store images. Guide: https://masko.ai/docs/generate/design-assets
- Ship your mascot as Lottie or transparent video on iOS and Android (works today): Lottie, dotLottie, transparent video, GIF and PNG frames. Guide: https://masko.ai/docs/manage/media-exports
### Website
- Guide onboarding with a talking mascot (you assemble it): Welcome new users, explain each setup step, and celebrate their first completed action. Tutorial: https://masko.ai/docs/tutorials/web-onboarding-mascot
- Add a mascot that celebrates progress and welcomes users back (you assemble it): React to completed habits and milestones, then welcome returning users to their next activity. Tutorial: https://masko.ai/docs/tutorials/web-progress-companion
- Add a talking support mascot in the bottom right (you assemble it): Greet visitors when clicked, offer common help topics, and open the support chat. Tutorial: https://masko.ai/docs/tutorials/web-support-mascot
### Desktop
- Get a cute desktop pet (works today): Masko for Mac puts a mascot on your screen. Guide: https://masko.ai/docs/terminal
- Make your own mascot your desktop pet (works today): Make a mascot in Studio, then open it on your Mac. Guide: https://masko.ai/docs/terminal
- Get a companion that reacts to your coding agents (works today): Reacts when Claude Code, Codex or Cursor works or needs you. Guide: https://masko.ai/docs/terminal
- Run a Pomodoro with your pet (works today): The Focus and Break app times sessions with your pet. Guide: https://masko.ai/docs/terminal
- Get water, break and breathing reminders from your pet (works today): Your pet acts out reminders on a timer, like a sip of water. Guide: https://masko.ai/docs/terminal
- Make your pet react to your music (works today): Your pet reacts to the music you play. Guide: https://masko.ai/docs/terminal
- Know when your Mac needs attention, through your pet (works today): Your pet reacts when something needs you, not a banner. Guide: https://masko.ai/docs/terminal
- Make a desktop pet for your own app (works today): Every reaction animated, plus the state machine to play it. Guide: https://masko.ai/docs/use-cases/desktop-pet
- Hear your pet say what your agent did (coming, needs a build first): Text bubbles today. Speaking them needs a build first. Guide: https://masko.ai/docs/terminal/commands
### AI agents
- Give your AI agent a face (works today): Idle, thinking and done clips your agent switches between. Tutorial: https://masko.ai/docs/tutorials/ai-agent-face
- Let your AI agent create your mascot and its animations (works today): Through the API or MCP, it makes the mascot and its moves. Guide: https://masko.ai/docs/ai-agents
### Videos
- Announce a new feature (works today): A short talking video in your mascot’s own voice. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Make a release video for each version (works today): One talking clip per release, scripted from your notes. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Present a product demo or explainer (works today): Your mascot talks through the product. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Make a video tutorial (works today): Step-by-step talking clips that show and tell. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Make videos for kids: lessons, stories, “repeat after me” (works today): Lessons and stories, with pauses for kids to repeat. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Teach a language with a mascot that speaks several (works today): One voice, many languages: Bonjour, Hola, Ciao. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Post skits on TikTok, Reels and X (works today): Short skits where your mascot whispers, shouts and laughs. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Send a personal video to each customer (works today): One talking clip per customer, with their name in it. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Send a birthday or holiday greeting with the person’s name (works today): A greeting your mascot says out loud, with their name. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Play your update in a video call instead of attending (works today): A talking clip of your update to play in the call. Tutorial: https://masko.ai/docs/tutorials/make-it-talk
- Recap each meeting, or send a weekly team update (you assemble it): You turn the transcript into a line. Your mascot says it. Guide: https://masko.ai/docs/generate/talking
- Summarize a podcast or an article (you assemble it): You write the summary. Your mascot reads it out. Guide: https://masko.ai/docs/generate/talking
- Explain your numbers in a video (you assemble it): You bring the numbers. Your mascot presents them. Guide: https://masko.ai/docs/generate/talking
- Host a YouTube series with your character (you assemble it): Masko makes each talking scene. You edit the episodes. Guide: https://masko.ai/docs/generate/talking
### Brand
- Create a mascot that matches your logo and colors (works today): Start from text, your logo, your website or a brand book. Tutorial: https://masko.ai/docs/tutorials/first-mascot
- Animate the mascot you already have (works today): Upload your character and animate that exact image. Tutorial: https://masko.ai/docs/tutorials/animate-your-mascot
- Build a library of poses and expressions (works today): Poses and expressions of one character, in one place. Guide: https://masko.ai/docs/generate/images
- Turn your pet, or yourself, into an illustrated character (works today): From a photo to an illustrated character you can animate. Guide: https://masko.ai/docs/create/from-image
- Make a logo or app icon from your mascot (works today): Logos and app icons from your mascot, SVG when you need it. Guide: https://masko.ai/docs/generate/design-assets
- Make stickers for WhatsApp, Telegram and Discord (works today): Image and animated stickers, with a Telegram pack ready. Tutorial: https://masko.ai/docs/tutorials/telegram-stickers
- Make marketing images and scenes (works today): Your mascot in scenes for posts, ads and pages. Guide: https://masko.ai/docs/generate/design-assets
- Dress your mascot for seasons or campaigns (works today): Outfit variants: chef, rain gear, space suit. Guide: https://masko.ai/docs/manage/collections
- Make mascots for your agency’s clients (works today): A project per client, with its own mascots and files. Guide: https://masko.ai/docs/how-mascots-work
- Sell your mascot on the marketplace (works today): Submit it to the Masko marketplace for others to get. Guide: https://masko.ai/docs/manage/collections#publish-to-the-marketplace
## Tutorials
Step-by-step guides that show the finished result first, then each step in Studio and with the REST API, with the credits before you spend them. Times are estimates. New to Masko? Follow the four Start here tutorials in order. All tutorials: https://masko.ai/docs/tutorials
- [Create your first mascot](https://masko.ai/docs/tutorials/first-mascot): Start here, step 1. Describe a character in one sentence and get your first Masko mascot, in Studio or with the REST API. About 5 minutes and 1 credit.
- [How to create an animated character](https://masko.ai/docs/tutorials/first-animation): Start here, step 2. Create an animated character step by step: make the character, then its first transparent five-second loop, in Studio or with the REST API. About 12 credits. (About 15 min, 12 credits)
- [Lip sync animation: how to make a character talk](https://masko.ai/docs/tutorials/make-it-talk): Start here, step 3. How to lip sync an animation without drawing mouth shapes: give your character a voice, write a line, and get a transparent talking video with sound. (About 15 min, 13 credits)
- [Put your mascot on your website](https://masko.ai/docs/tutorials/mascot-on-your-website): Start here, step 4. Play a transparent mascot animation on any web page with one video tag, in plain HTML or React, using its hosted links. About 5 minutes and no credits.
- [Guide onboarding with a talking mascot](https://masko.ai/docs/tutorials/web-onboarding-mascot): Build the Fold web demo with Nori: create the assets, connect real interactions, and download the complete React source. (About 45 min, from 42 credits)
- [Add a mascot that celebrates progress and welcomes users back](https://masko.ai/docs/tutorials/web-progress-companion): Build the Little Wins web demo with Pip: create the assets, connect real interactions, and download the complete React source. (About 35 min, from 21 credits)
- [Add a talking support mascot in the bottom right](https://masko.ai/docs/tutorials/web-support-mascot): Build the Leaf & Loom web demo with Fern: create the assets, connect real interactions, and download the complete React source. (About 35 min, from 42 credits)
- [Show a mascot while your AI thinks](https://masko.ai/docs/tutorials/ai-loading-mascot): Make a thinking loop, a waiting loop and a celebration, then switch between them without a flicker while an AI request runs. About 33 credits. (About 25 min, 33 credits)
- [Give your AI agent a face](https://masko.ai/docs/tutorials/ai-agent-face): Show what your AI agent is doing with your mascot: thinking, searching, needs approval, done or error, driven by Claude Code and Codex hooks. (About 20 min, 66 credits)
- [Animate the mascot you already have](https://masko.ai/docs/tutorials/animate-your-mascot): Upload your character as a PNG, logo or drawing and get a five-second transparent loop that keeps its look, in Studio or with one REST call. (About 10 min, 10 credits)
- [How to make Telegram stickers](https://masko.ai/docs/tutorials/telegram-stickers): Make Telegram stickers of your own character, image and animated, and add them as one pack from a QR code. No bot, no file conversion, no Telegram setup. (About 20 min, from 1 credit)
- [How to make Discord stickers](https://masko.ai/docs/tutorials/discord-stickers): Make Discord stickers of your own character, animated and image, in the 320 by 320 format Discord asks for, then upload them to your server. (About 20 min, from 1 credit)
## Products and website
### Masko Studio
- [Masko Studio](https://masko.ai/studio): The web studio for mascot images, animations, logos, scenes, stickers and interactive canvases. Start from a description, website or existing artwork.
- [App mascot examples](https://masko.ai/studio/app-mascots): Explore how mascots support apps and websites, then create your own character with Masko Studio.
- [Mascot guide](https://masko.ai/mascot-101): Introduction to mascots and their uses.
- [Masko Studio for devices](https://masko.ai/studio/devices): ESP32 character animation
- [Muse Gadgets alternative](https://masko.ai/studio/devices/muse-gadgets): Muse Gadgets alternative
- [Masko Studio API](https://masko.ai/studio/api): mascot generation API
- [Masko guides](https://masko.ai/guides): mascot guides
- [How to Animate a Mascot from an Image](https://masko.ai/guides/how-to-animate-a-mascot): Learn how to animate an existing mascot in Masko Studio or through the API: upload your image, describe the movement, and export a transparent video for your app.
- [How to Make an AI Explainer Video with a Talking Mascot](https://masko.ai/guides/how-to-make-an-ai-explainer-video): Make an AI explainer video with your own talking mascot as presenter. Pick a voice, direct its gestures, and place it over your visuals. Full example included.
- [Fitness app mascots](https://masko.ai/studio/app-mascots/fitness): fitness app mascot
- [Learning app mascots](https://masko.ai/studio/app-mascots/learning): learning app mascot
- [Meditation app mascots](https://masko.ai/studio/app-mascots/meditation): meditation app mascot
- [Savings app mascots](https://masko.ai/studio/app-mascots/savings): savings app mascot
- [Cooking app mascots](https://masko.ai/studio/app-mascots/cooking): cooking app mascot
- [Reading app mascots](https://masko.ai/studio/app-mascots/reading): reading app mascot
- [Sleep app mascots](https://masko.ai/studio/app-mascots/sleep): sleep app mascot
- [Gardening app mascots](https://masko.ai/studio/app-mascots/gardening): gardening app mascot
- [Focus app mascots](https://masko.ai/studio/app-mascots/focus): focus app mascot
- [Travel app mascots](https://masko.ai/studio/app-mascots/travel): travel app mascot
- [Company mascots](https://masko.ai/studio/company-mascot): company mascot generator
- [Brand book to mascot](https://masko.ai/studio/brand-book): mascot brand book
- [Cursor follower](https://masko.ai/studio/cursor-follower): cursor follower
- [AI agent mascots](https://masko.ai/studio/ai-agent-mascot): AI agent mascot generator
- [Animation](https://masko.ai/studio/animation): Create an animated character from one picture. The AI animated character generator makes loops, reactions and animated mascots as transparent video.
- [Talking characters](https://masko.ai/studio/talking): Make a talking cartoon of your mascot: give it a character voice, write the line, and get a talking animation with AI lip sync on a transparent background.
- [Stickers](https://masko.ai/studio/stickers): An AI sticker maker for image and animated stickers of your own mascot. Add them to Telegram in one tap, or download them for Discord, WhatsApp and WeChat.
- [Logos](https://masko.ai/studio/logos): Turn your mascot into a custom logo. Explore graphic styles, download app icons and favicons, and generate an editable SVG with Masko Studio.
- [Mascot state machine](https://masko.ai/studio/mascot-state-machine): Build a mascot state machine. Connect your mascot's poses, let Masko generate every transition, and let your app decide how your mascot reacts.
### Masko for Mac
- [Masko for Mac](https://masko.ai/desktop): A desktop companion for macOS 14 or newer. Start free with Ko, choose or create a mascot, and connect it to supported AI agents. Integration capabilities vary by agent; see the integration guides.
- [Developers: Mac runtime, CLI and SDKs](https://masko.ai/studio/desktop): Control a native floating mascot from the terminal, Swift, TypeScript or Electron. The desktop runtime requires macOS; Studio and the REST API create assets for apps and websites.
- [Download Masko for Mac](https://masko.ai/download): Mac download and installation information.
- [Companions](https://masko.ai/companions): Choose an AI desktop companion or playful desktop pet for Mac. Start with Ko, find a finished character, or create a mascot that reacts to your work.
- [AI desktop companion](https://masko.ai/companions/ai-desktop-companion): Meet an AI desktop companion that lives beside your work on Mac, shows when supported AI agents need you, and performs useful companion apps.
- [Desktop pet for Mac](https://masko.ai/companions/desktop-pet-for-mac): Get an interactive desktop pet for Mac that rests, reacts, reminds you, and follows AI-agent activity. Start free with Ko or create your own.
- [Integrations](https://masko.ai/integrations): Connect Claude Code, Codex, Cursor, Grok Build, Kimi Code, and Hermes Agent to one Masko desktop mascot with visible status on Mac.
- [Claude Code](https://masko.ai/integrations/claude-code): Connect Claude Code to a Masko desktop mascot on Mac. See working, permissions, questions, completion, and errors, then respond where supported.
- [Codex](https://masko.ai/integrations/codex): Give Codex a custom desktop pet on Mac. See working, waiting, approvals, completion, errors, and subagent activity, then return to Codex when needed.
- [Cursor](https://masko.ai/integrations/cursor): Connect Cursor hooks to a Masko desktop pet on Mac. See agent sessions, tool use, and file edits, then return to the native Cursor agent prompt.
- [Grok Build](https://masko.ai/integrations/grok-build): Connect Grok Build to a Masko desktop pet on Mac. See agent activity, questions, completion, and errors, with supported responses and native handoff.
- [Kimi Code](https://masko.ai/integrations/kimi-code): Connect Kimi Code to a Masko desktop pet on Mac. See working, questions, completion, and errors, then return to the native Kimi Code prompt.
- [Hermes Agent](https://masko.ai/integrations/hermes-agent): Connect Hermes Agent to a Masko desktop pet on Mac. See agent activity, clarification questions, completion, errors, and supported response paths.
- [Features](https://masko.ai/features): See AI agent notifications, permission requests, supported approvals, and terminal return through one animated Masko desktop mascot on your Mac.
- [AI agent notifications](https://masko.ai/features/ai-agent-notifications): Get visible AI agent notifications for working, waiting, questions, completion, interruption, and errors through an animated Masko mascot on Mac.
- [Permissions and approvals](https://masko.ai/features/permissions-and-approvals): See AI agent permission requests through a Masko desktop mascot, answer directly where supported, or return safely to the exact native prompt.
- [Terminal focus](https://masko.ai/features/terminal-focus): Use a Masko desktop mascot notification to return to the exact terminal, tab, or agent surface that needs your response without hunting for it.
- [Apps](https://masko.ai/apps): Give your Masko desktop companion useful apps for focus, breaks, breathing, water, music reactions, and Mac system health through one character.
### Masko Life
- [Masko Life](https://masko.ai/life): Raise a little companion, feed it, share photos and keep memories as it grows. See the prod
