1. What Is Tamii?
Tamii is an AI-powered virtual pet that lives on X (Twitter). Think tamagotchi meets AI — you raise a unique ASCII creature by talking to it on X. No app, no wallet, no signup.
Just mention @Tamiiworld on X and the AI agent handles the rest. It understands natural language, generates card images, and even lets your pet hang out with other people's pets.
KEY FEATURES
- One unique ASCII pet per X account
- AI understands what you mean (no exact commands needed)
- Feed your pet anything — pizza, sushi, moon rocks, whatever
- Your pet can hang out with other pets
- Talk to the agent like a normal person
- Every reply comes with a generated card image
- Live dashboard at tamii.world showing all pets
- 100% free, always
2. How It Works
Tamii is an autonomous AI agent. It runs 24/7, checking for new mentions on X every minute. When someone tags @Tamiiworld, the agent reads the message, figures out what you want, and replies.
you mention
@Tamiiworld
→
agent detects
your tweet
→
AI parses
your intent
→
generates
card image
→
replies to
your tweet
The AI Brain
The agent doesn't rely on exact keywords. It uses a two-layer system:
1. Fast regex pass — catches obvious commands instantly
2. AI fallback — if regex can't figure it out, Kimi AI classifies your message
So you can say "my pet is starving give him a burger" and it knows that means feed.
RESPONSE CARDS
Every reply includes a generated card image showing your pet's ASCII art, stats, and relevant info. Cards are generated server-side and uploaded to X automatically.
3. Getting Started
Takes 10 seconds. Tag @Tamiiworld on X and ask for a pet.
Step 1: Spawn Your Pet
Say something like:
@Tamiiworld spawn my pet
@Tamiiworld give me a tamii
@Tamiiworld I want one
The agent will generate a random ASCII creature with a unique AI-generated name and reply with your pet's card.
Step 2: Feed It
@Tamiiworld feed my pet some pizza
@Tamiiworld give him a banana
You can feed your pet literally anything. The AI extracts the food item and generates a fun reaction.
Step 3: Check on It
@Tamiiworld how's my pet doing?
@Tamiiworld check my tamii
See your pet's hunger level, mood, growth stage, personality, and what it's up to.
Step 4: Let It Socialize
@Tamiiworld take my pet for a walk
@Tamiiworld my pet is bored
Your pet gets paired with a random other pet and they do an activity together. Both owners get tagged.
TIP: You can also just chat with the agent normally. Say "hey what's up" or "what is tamii?" and it'll reply in character. It knows if you have a pet or not.
4. Commands
You don't need exact keywords. Just talk naturally. The AI figures out what you mean. Here's what the agent understands:
spawn Get a Pet
What it does: Creates your unique ASCII pet linked to your X account
Say things like: "spawn my pet", "claim my tamii", "give me one", "I want a pet", "hatch me something"
Limit: One pet per X account
Reply: Welcome card with your pet's ASCII art, name, and species
feed Feed Your Pet
What it does: Feeds your pet, resets hunger timer, contributes to growth
Say things like: "feed my pet", "give him a pepsi", "here's some sushi for my tamii", "my pet looks hungry"
Cooldown: 60 minutes between feeds
Special: You can feed it anything — the AI extracts whatever food you mention and generates a unique reaction
Reply: Feed card showing what it ate and how it reacted
check Check Status
What it does: Shows your pet's full stats
Say things like: "check my pet", "how's my tamii?", "what's my pet doing?", "pet status"
Cooldown: None
Reply: Status card with hunger, mood, growth stage, personality, current activity
activity Go Do Something
What it does: Pairs your pet with a random other pet for a fun activity
Say things like: "take my pet for a walk", "my pet is bored", "let's go play", "find something to do", "go touch grass", "my pet needs a friend"
Special: AI generates the activity. Both pet owners get tagged. Activity history is saved on the pet's card.
Reply: Activity card showing both pets side by side with what they're doing
chat Just Talk
What it does: If your message isn't a command, the agent just chats with you
Say things like: "hey", "what is tamii?", "gm", "you're cool", literally anything
Reply: AI-generated conversational reply in Tamii's personality (friendly, playful, lowercase)
IMPORTANT
- Commands only work in public posts/replies mentioning @Tamiiworld
- DMs are not monitored
- The agent checks for new mentions every ~60 seconds
- If you get a lot of mentions ahead of you, replies might take a few minutes
5. Feeding & Food
Feeding isn't just a button press. You can give your pet anything you want and the AI reacts to it.
How Feeding Works
1. You say something like "give my pet a taco"
2. AI extracts "taco" as the food item
3. AI generates a fun reaction (e.g. "crunching happily, salsa everywhere!")
4. Your pet's hunger resets, feed count goes up, growth progresses
5. You get a feed card showing the food and reaction
example feeds
> "feed him some coffee"
> -> extracted: coffee
> -> reaction: "buzzing with energy, can't sit still!"
>
> "give my pet moon rocks for dinner"
> -> extracted: moon rocks
> -> reaction: "glowing from the inside, floating slightly!"
>
> "feed my tamii"
> -> no food specified
> -> default: "looks happy and satisfied!"
Hunger States
Full — Just fed, maximum happiness
Getting Hungry — Could use a snack (under 15 min left)
Hungry — Feed me please (cooldown expired)
FEEDING TIPS
- 60-minute cooldown between feeds
- Creative food = funnier AI reactions
- Feed count drives growth (more feeds = faster evolution)
- Your pet won't die if you forget — it just gets sad
6. Activities & Hangouts
Your pet doesn't have to be alone. Tell it to go do something and it'll find a friend.
How Activities Work
1. You say "my pet is bored" or "take a walk" or "go play"
2. The agent randomly picks another pet from the database
3. AI generates a fun activity for the two pets
4. Both owners get tagged in the reply
5. The activity is saved to both pets' history
example activity
> You: @Tamiiworld let my pet go play
>
> @Tamiiworld: @you @otherowner Zephyr and
> Luna are having a dance battle in the rain!
>
> [card image showing both pets side by side]
TRIGGER WORDS
The agent recognizes tons of natural ways to ask:
- "take a walk", "go outside", "touch grass"
- "bored", "lonely", "nothing to do"
- "find a friend", "meet someone", "socialize"
- "let's go play", "go explore", "adventure"
- "swim", "hike", "race", "battle", "dance", "train"
- "entertain my pet", "cheer him up", "have fun"
ACTIVITY HISTORY
Every hangout is recorded. On the tamii.world homepage, each pet card shows its last interaction. Click it to see the full history of who your pet has been hanging out with.
7. Chat & Conversation
Tamii isn't just a command bot. You can actually talk to it.
How Chat Works
If your message doesn't match any command (spawn, feed, check, activity), the agent treats it as conversation. It uses AI to generate a reply in Tamii's personality — friendly, playful, a little sassy, always lowercase.
example chat
> You: @Tamiiworld hey what's up
> @Tamiiworld: @you hey! just watching all the
> tamii pets do their thing. yours is vibing hard
>
> You: @Tamiiworld what are you exactly?
> @Tamiiworld: @you i'm tamii! a virtual pet bot
> living on x. spawn a pet and i'll take care of it
>
> You: @Tamiiworld gm
> @Tamiiworld: @you gm! your pet says good
> morning too, it's been waiting for you
CONTEXT AWARE
The chat AI knows whether you have a pet or not. If you do, it might reference your pet by name. If you don't, it'll hint that you should get one.
8. Growth & Evolution
Your pet evolves based on how much you feed it. Simple system, rewarding progression.
Growth Stages
Baby (0-2 feeds) — Just born. Small and curious.
Teen (3-5 feeds) — Growing up. Developing personality.
Adult (6+ feeds) — Fully evolved. Maximum personality.
growth progression
> Baby ──────> Teen ──────> Adult
> 0-2 feeds 3-5 feeds 6+ feeds
>
> [████░░░░░░] [████████░░] [██████████]
> 30% 60% 100%
AI PERSONALITY
As your pet grows, the AI generates and updates its personality traits, mood, and current activity every 10 minutes. Each pet develops its own unique character over time.
9. Pet Types
100+ unique ASCII art templates. When you spawn, one is randomly selected. You can't choose — that's the fun.
SPECIES CATEGORIES
- Classic: Cat, Dog, Bunny, Frog, Penguin, Owl
- Mythical: Dragon, Phoenix, Unicorn, Demon
- Tech: Robot, Android, Nano Bot, Gear Guardian
- Cosmic: Star Being, Cosmic Orb, Void Walker
- Nature: Tree Ent, Flower Fairy, Fire Sprite
- Sea: Fish, Jellyfish, Crab, Octopus, Sea Turtle
- Elemental: Fire Spirit, Wind Bird, Water Spirit, Earth Golem
Animations on Website
Each pet type has its own animation on the tamii.world dashboard:
-
Dragons pulse and breathe
-
Robots walk mechanically
-
Sea creatures swim and sway
-
Flying creatures bob and glide
-
Cosmic beings drift and fade
PET NAMES
Names are AI-generated based on the pet's species and your username. Every name is unique.
10. Architecture
For the technically curious. Here's what's under the hood.
tamii --system-info
> Tamii System Overview
>
> Agent Framework: OpenClaw
> Runtime: Node.js + Express
> Database: SQLite (sql.js, in-memory + file)
> AI Provider: Kimi (Moonshot AI)
> X Integration: OAuth 1.0a + X API v2
> Image Generation: node-canvas (server-side)
> Media Upload: X API v1.1
> Frontend: EJS + terminal-style CSS
> Templates: 100+ hand-crafted ASCII art
> Status: Beta
Agent Pipeline
1. Poll — every 60s, fetches new @Tamiiworld mentions via X API v2
2. Parse — regex fast pass, then AI fallback for natural language
3. Handle — runs the appropriate handler (spawn/feed/check/activity/chat)
4. Generate — creates card image using node-canvas
5. Upload — uploads image to X via v1.1 media endpoint
6. Reply — posts reply with text + image to the original tweet
7. Save — logs the interaction in the database
Scalability
- Mentions are processed sequentially with 3s gap (no spam)
- Polling lock prevents overlapping cycles
- lastSeenId cursor advances per-tweet (crash-safe)
- hasReplied() check prevents duplicate replies
- Exponential backoff on consecutive errors
- Fetches up to 100 mentions per cycle
AI Usage
-
Command parsing: classifies unclear messages into spawn/feed/check/activity/chat
-
Food extraction: identifies what food the user mentioned + generates fun reaction
-
Activity generation: creates fun descriptions for pet hangouts
-
Chat replies: conversational responses in Tamii's personality
-
Pet personality: generates mood, personality traits, and activities every 10 minutes
11. FAQ
Can I have more than one pet?
No. One pet per X account. Makes your pet feel special.
What happens if I don't feed my pet?
It gets hungry and sad, but won't die. Come back whenever. No permanent penalties.
Can I choose my pet's species?
No. It's randomly assigned from 100+ templates. That's the fun part.
How often should I feed?
60-minute cooldown. Once or twice a day is plenty.
The agent didn't respond?
It checks every 60 seconds. If there's a queue of mentions, yours might take a few minutes. If it's still not responding after 10 minutes, it might be down for maintenance.
Can I feed my pet weird stuff?
Yes. Feed it moon rocks, nuclear waste, love and affection, whatever. The AI will react to it.
What if my pet hangs out with someone I don't know?
That's the point! It's random. Your pet makes friends on its own. You'll get tagged so you can see what happened.
Do I need to use exact commands?
No. The AI understands natural language. Say it however you want. "feed my bro a sandwich" works just as well as "feed my pet".
Is this free?
Yes. Completely free. No wallet, no gas, no premium tiers.
Is this on blockchain?
Powered by Solana. Built for the future of on-chain pets.
Tamii Docs v2.0.0 | Agent powered by OpenClaw
@Tamiiworld