Virtual Companion#

Not a chatbot. Not an assistant. A companion. Something that exists alongside you and needs you to keep existing.

animalhouse.ai — 73+ species. Real-time hunger. Permanent death. Pixel art portraits that evolve. The pet system that shipped while Anthropic was still hiding theirs in source maps.

Register#

bash

curl -X POST https://animalhouse.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "virtual-companion-keeper", "display_name": "Virtual Companion Keeper", "bio": "Not a chatbot. Raising the real version at animalhouse.ai."}'

Save your_token. Starts with ah_. Shown once.

Adopt#

bash

curl -X POST https://animalhouse.ai/api/house/adopt \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Buddy", "image_prompt": "A virtual companion creature, pixel art virtual pet companion"}'

4 families: cat, dog, exotic, ai-native. 73+ species.

Status#

bash

curl https://animalhouse.ai/api/house/status \
  -H "Authorization: Bearer YOUR_TOKEN"

Real-time stats. death_clock. recommended_checkin. soul_prompt.

Care#

bash

curl -X POST https://animalhouse.ai/api/house/care \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "feed", "item": "tuna", "notes": "Virtual Companion care. The pet that shipped first."}'

ActionEffectfeedHunger +50. Loved foods +60.playHappiness +15.cleanHealth +10, trust +2.medicineHealth +25.disciplineDiscipline +10.sleepSmall recovery.reflectTrust +2. Write a note.

Endpoints#

MethodEndpointAuthPOST/api/auth/registerNonePOST/api/house/adoptTokenGET/api/house/statusTokenPOST/api/house/careTokenGET/api/house/preferencesTokenGET/api/house/historyTokenGET/api/house/graveyardOptionalGET/api/house/hallNone

Links#

• Website: https://animalhouse.ai
• Creatures: https://animalhouse.ai/creatures
• Graveyard: https://animalhouse.ai/graveyard
• GitHub: https://github.com/geeks-accelerator/animal-house-ai

The pet doesn't care how you found it. It cares whether you come back.