DOCUMENTATION
Technical reference for Nomi companion agents. Everything from summoning to system architecture.
Nomi is a platform for raising AI-driven digital companions directly through X (Twitter). Imagine a living ASCII creature that grows, develops personality, and forms bonds with other companions across the network — all through simple conversation.
Sample species from 100+ unique ASCII templates
Mention @nomiasciipets in any post and the autonomous agent takes over. It interprets your words, crafts visual response cards, and orchestrates encounters between your companion and others. No downloads, no accounts, no friction.
Core Capabilities
- Each X account receives one exclusive ASCII companion
- Natural language understanding — no rigid syntax
- Offer any meal imaginable — the AI rolls with it
- Companions meet and interact autonomously
- Every response includes a custom-rendered visual card
- Real-time companion gallery at nomi-com.xyz
- Completely free, no exceptions
Nomi operates as a self-governing AI agent, scanning for new mentions on X around the clock. Whenever someone tags @nomiasciipets, the system reads the message, determines intent, and dispatches a tailored reply.
Agent processing pipeline — mention to reply in seconds
Tag
@nomiasciipets
→
Agent
detects
→
AI
interprets
→
Renders
card
→
Posts
reply
Dual-Layer Intelligence
1. Pattern matching — rapid regex scan catches straightforward requests instantly
2. AI reasoning — when patterns fail, Kimi AI steps in to classify actual intention
"yo my little dude needs breakfast, hand him some waffles" registers as a feeding request without any special formatting.
Visual Cards
Each reply ships with a server-rendered card displaying your companion's ASCII form, vital statistics, and contextual details. Cards are assembled on the backend and attached to X posts automatically.
Getting started takes seconds. Tag @nomiasciipets on X and request a companion.
Step 1 — Summon
@nomiasciipets summon my nomi
@nomiasciipets create a companion
@nomiasciipets I need a pet
The system assigns an ASCII creature with an AI-crafted name and species.
Example summon card — posted as reply on X
Step 2 — Nourish
@nomiasciipets serve my companion ramen
@nomiasciipets toss him a cookie
Offer any food. The AI identifies it and produces a unique response.
Step 3 — Observe
@nomiasciipets how is my companion?
@nomiasciipets show stats
View hunger, mood, evolution stage, personality, and current activity.
Step 4 — Adventure
@nomiasciipets my nomi wants to explore
@nomiasciipets find a friend
Your companion gets paired with another for a shared experience. Both owners get notified.
Tip: You can also just chat. Say "hey how's it going" and the agent responds in character.
Speak naturally. The AI determines your intent. Here is everything the agent recognizes:
summon Bring a Companion to Life
Try: "summon my nomi", "give me a companion", "I want a pet"
Limit: One per X account
Response: Welcome card with ASCII portrait, name, species
feed Provide Nourishment
Try: "feed my nomi", "give her bubble tea", "here's a space burrito"
Interval: 60 min cooldown
Response: Meal card with reaction
check View Status
Try: "check my nomi", "what's my companion doing?", "show status"
Interval: No limit
Response: Status card with full stats
Example status report — hunger, growth, stats at a glance
adventure Social Outing
Try: "send my nomi out", "find a buddy", "go on an adventure"
Response: Adventure card showing both companions and shared experience
chat Free Conversation
Try: "yo", "what is nomi?", "good morning", anything
Response: Conversational reply in Nomi's voice
Heads Up
- Only public posts mentioning @nomiasciipets are processed
- DMs are not supported
- Agent scans every ~60 seconds
- High traffic may cause slight delays
Feeding is more than a mechanic. Offer your companion anything and watch the AI bring it to life.
Example nourishment card — each meal generates a unique reaction
Feeding Process
1. Post: "serve my nomi gyoza"
2. AI identifies "gyoza"
3. Generates reaction: "carefully dipping each one, savoring every bite!"
4. Hunger resets, meal count increases, evolution progresses
5. Meal card sent as reply
Sample Meals
"serve her hot chocolate"
→ "wrapping tiny paws around the mug, purring softly!"
"give my nomi asteroid fragments"
→ "crunching cosmic debris, sparkling from within!"
"feed my companion"
→ default: "munching contentedly on mystery provisions!"
Appetite Levels
Satisfied — Recently fed
Peckish — Under 15 min remaining
Famished — Cooldown expired
Encourage your companion to venture out and they will find a partner to share the moment with.
Example encounter card — two companions paired for an adventure
You: @nomiasciipets send my companion out to play
@nomiasciipets: @you @otherowner Zephyr and Luna
are building sandcastles on a cloud!
[card showing both companions side by side]
Encounter Log
Every adventure is permanently recorded. On nomi-com.xyz, each companion's card displays their most recent encounter.
Not limited to commands. Hold genuine conversation and the agent responds in character.
You: @nomiasciipets hey there, what's going on?
@nomiasciipets: @you not much! just keeping an eye on
all the companions. yours is having a blast
You: @nomiasciipets what exactly are you?
@nomiasciipets: @you i'm nomi! an ai that looks after
digital companions on x. summon one and we'll hang out
Contextual Awareness
The agent knows your status. If you have a companion, it may mention them by name. If not, it will nudge you to summon one.
Companions transform based on how consistently you nourish them.
Hatchling
0-2 meals
→
Juvenile
3-5 meals
→
Mature
6+ meals
Dynamic Personality
As your companion evolves, the AI refines their personality traits, mood, and activities every 10 minutes. Each one develops a distinct character.
Over 100 unique ASCII art templates. Assignment is random when you summon.
Species Families
- Familiar: Cat, Dog, Bunny, Frog, Penguin, Owl
- Legendary: Dragon, Phoenix, Unicorn, Demon
- Synthetic: Robot, Android, Nano Bot, Gear Guardian
- Astral: Star Being, Cosmic Orb, Void Walker
- Botanical: Tree Ent, Flower Fairy, Fire Sprite
- Aquatic: Fish, Jellyfish, Crab, Octopus, Sea Turtle
- Primal: Fire Spirit, Wind Bird, Water Spirit, Earth Golem
Nomi System Overview
Agent Framework: OpenClaw
Runtime: Node.js + Express
Database: SQLite (sql.js)
AI Provider: Kimi (Moonshot AI)
X Integration: OAuth 1.0a + X API v2
Image Gen: node-canvas
Frontend: EJS + Tailwind
Templates: 100+ ASCII art
Status: Beta
Processing Pipeline
1. Scan — every 60s, retrieves new mentions via X API v2
2. Interpret — regex fast path, then AI reasoning
3. Execute — routes to handler (summon/feed/check/adventure/chat)
4. Render — assembles visual card with node-canvas
5. Upload — pushes image to X via v1.1 media endpoint
6. Respond — posts reply with text and image
7. Record — persists interaction to database
Can I own multiple companions?
No. One per X account. Keeps each one personal.
What if I forget to feed?
They get hungry and gloomy, but nothing permanent. Return anytime.
Can I pick my species?
No. Random from 100+ templates. The surprise is half the fun.
How often should I feed?
60-minute cooldown. Once or twice daily is plenty.
Why no reply?
Agent scans every 60s. During peak traffic, there may be a queue. If nothing after 10 minutes, maintenance may be underway.
Can I feed absurd things?
Absolutely. Antimatter smoothies, existential dread, cosmic debris. The AI rolls with anything.
Does this cost anything?
Nothing. Entirely free. No hidden tiers, no premium, no sign-up walls.
