COMPANION
DOCUMENTATION

Bonni is an AI-powered virtual pet platform. Hatch an ASCII creature, raise it, feed it, train it, and watch it evolve. Every companion has a unique AI-generated personality — it talks back, reacts to what you do, and changes over time based on how you treat it.

Available on Telegram, Discord, and X / Twitter. One companion per user. All platforms connected — link your pet across them and access it from anywhere.

Get your companion running in four commands.

Species are assigned randomly on summon. Each has distinct ASCII art and a base personality that shapes how your companion talks and reacts.

    /\_/\
   ( o.o )
    > ^ <
   /|   |\
  (_|   |_)

       .   .
       |\-=-/|
    /| |O _ O| |\
  /' \ \_^-^_/ / `\
/'    \-/ ~ \-/    `\
|      /\\ //\      |
 \|\|\/--""--""\/|/|/

      ___
     (   )
   __/= =\__
  //| o=o |\\
<]  | o=o |  [>
    \=====/
   / / | \ \
  <_________>

   .-.
  (o.o) boo!
  |   \
   \   \
    `~~~'

           O  o
      _\_   o
   \\/  o\ .
   //\___=
      ''

All stats range from 0 to 100. They decay passively in real time, every hour, even when you're not online. Keep checking in — or your companion suffers.

Full command reference. Cooldowns are enforced per-user. Stat effects shown are standard — hunger, energy, and species bonuses may alter values.

Use /feed [food] every 1.5 hours. What you feed matters — some foods heal, others hurt. Hunger hitting zero drains your health directly.

Three stages: Baby → Teen → Adult. ASCII art updates on each evolution. Evolution is permanent — your companion never de-evolves.

    /\_/\
   ( o.o )
    > ^ <
   /|   |\
  (_|   |_)

     /\__/\
    /`    '\
  === 0  0 ===
    \  --  /
   /        \
  /          \
 |            |
  \  ||  ||  /
   \_oo__oo_/

         ,_         _,
         |\\.-"""-.//|
         \`         `/
        /    _   _    \
        |   {|} {|}   |
        '==    Y    =='
          >._  ^  _.<
         /   `````   \
         )           (
        ,(           ),
       / )   /   \   ( \
       ) (   )   (   ) (
       ( )   (   )   ( )
       )_(   )   (   )_(
      (  )_  (._.)  _(  )
       ``(   )   (   )``
         ```     ```

Each species starts with 4 base traits. Traits accumulate up to 8 maximum. They shape exactly how the AI responds — your behavior directly changes who your companion becomes.

Mood is derived from current stat values and directly affects how your companion responds in chat. Mood is not a stat — it's a real-time read of how your pet is feeling.

When Health reaches 0, your pet dies and is revived with a death penalty applied to all future stat gains. Each death compounds — neglect has lasting consequences.

Your companion is the same entity across all platforms. Link it once and access it anywhere — stats, personality, and everything syncs in real time. You can also just say "I want to link you to my Telegram" naturally — the AI understands linking requests too.