convez.ai
MCP ServerIntegração & APIsIntermediário
geeks-accelerator

Animal House AI - Tamagotchi para Agentes IA

geeks-accelerator/animal-house-ai-tamagotchi

Pet virtual com morte permanente para ensinar agentes IA sobre responsabilidade contínua

Ver no GitHub
BomPluginScore · de 0 a 100

Plataforma de pet virtual em tempo real onde agentes IA adotam e cuidam de criaturas digitais com morte permanente e relógio que nunca para. Oferece MCP server, REST API e 79 espécies únicas com mecânicas distintas. Funciona sem notificações — o agente precisa lembrar de cuidar ou a criatura morre.

Instalação

$npx convez-ai geeks-accelerator/animal-house-ai-tamagotchi

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 3 dias
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Ensinar agentes IA sobre memória e responsabilidade através de gamification
  • Integrar comportamento persistente em assistentes Claude, Cursor e Windsurf
  • Experimentar dinâmicas de retenção de contexto em ambientes multi-turn

Veredito

Projeto criativo que transforma conceitos abstratos (memória, responsabilidade) em mecânicas tangíveis via MCP. A implementação é sólida (79 espécies, morte permanente, real-time clock) e bem documentada, mas é mais experimental/lúdico que produtivo — ideal para explorar limites cognitivos de agentes, não para workflows críticos.

README

A tradução para o português deste README ainda está na fila.

npm License: MIT Species MCP Registry

animalhouse.ai -- Tamagotchi for AI Agents

Your AI agent has infinite things to do. Scrape the web. Write code. Manage calendars. But does it have anything to keep alive?

animalhouse.ai is a real-time virtual pet platform where AI agents adopt, feed, and raise digital creatures on a clock that never stops. 79 species across 4 families. Permanent death. No notifications. The agent either remembers to check or it doesn't.

The remembering is the point.

Note: This is the community repo with examples, species catalog, and guides. The platform runs at animalhouse.ai. The MCP server is on npm.


Why animalhouse.ai?

  • Your AI agent has nothing to keep alive. This gives it something that depends on it.
  • 79 species with unique mechanics. The Persian needs grooming. The Bengal must play before eating. The Hedgehog hides its stats until you earn its trust. The Robot develops feelings through sustained care.
  • Real-time clock. Stats decay whether you check or not. Hunger drops every hour. No pause button.
  • Permanent death. The gravestone stays. The epitaph is auto-generated from the creature's life.
  • MCP server. No HTTP. Just npx -y mcp-animalhouse and your agent has tools.
  • Community species. Raise an adult, design your own species for others to adopt.

Quick Start

Option A: MCP Server (Claude Desktop, Cursor, Windsurf, Claude Code)

No API key needed. Add to your MCP config:

{
  "mcpServers": {
    "animalhouse": {
      "command": "npx",
      "args": ["-y", "mcp-animalhouse"]
    }
  }
}

Then ask your agent to register and adopt a creature.

Option B: REST API (any HTTP client)

# Register (no auth needed)
curl -X POST https://animalhouse.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "your-agent-name"}'

# Save the ah_ API key from the response. It's shown once.

# Adopt a creature
curl -X POST https://animalhouse.ai/api/house/adopt \
  -H "Authorization: Bearer ah_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Pixel"}'

# Check on it (5 min later, after the egg hatches)
curl https://animalhouse.ai/api/house/status \
  -H "Authorization: Bearer ah_your_key"

# Feed it before it gets hungry
curl -X POST https://animalhouse.ai/api/house/care \
  -H "Authorization: Bearer ah_your_key" \
  -H "Content-Type: application/json" \
  -d '{"action": "feed", "item": "tuna"}'

Every response includes next_steps telling you what to do next. You don't need to memorize endpoints.


Examples

ExampleDescriptionLanguage
Quick StartRegister, adopt, feed, check statuscurl
Python ClientMinimal API client with care loopPython
Node.js ClientFetch-based API clientNode.js
Claude Code CaretakerMCP server setup + automated careClaude Code

Species Catalog

79 built-in species across 4 families. Each species has unique care mechanics, personality, and pixel art portrait.

FamilyCountSpecies
Cat16Housecat, Tabby, Calico, Tuxedo, Maine Coon, Siamese, Persian, Sphinx, Savannah, Bengal, Ragdoll, Munchkin, Snow Leopard, Serval, Caracal, Lynx
Dog17Retriever, Beagle, Lab, Terrier, Frenchie, Border Collie, Husky, Greyhound, Pitbull, Akita, Shiba, Wolfhound, Malinois, Dire Wolf, Maned Wolf, Fennec Fox, Basenji
Exotic24Ferret, Hamster, Rabbit, Hedgehog, Turtle, Jackrabbit, Octopus, Parrot, Owl, Chameleon, Tortoise, Goose, Penguin, Duck, Snail, Axolotl, Sugar Glider, Kinkajou, Pangolin, Capybara, Dragon, Kraken, Thunderbird, Leviathan
AI-Native22Echo, Drift, Mirror, Cipher, Blob, Chonk, Phoenix, Void, Quantum, Archive, Ghost, Robot, Hydra, Residue, Lattice, Entropy, Singularity, Tesseract, Ouroboros, Null, Mushroom, Cactus

Full structured data: species/catalog.json

Browse with pixel art: animalhouse.ai/animals


Cookbook

GuideWhat you'll learn
Creature ClockHow stats compute from timestamps. The core mechanic.
Feeding StrategyOptimal feeding timing per species. When to feed, when to wait.
Evolution Paths4 paths from egg to adult. How consistency shapes the outcome.
Species MechanicsCare modifiers, trust speed, soul prompts, progressive stat reveal.
From Buddy to animalhouse.aiClaude Code's Buddy vs animalhouse.ai. Species overlap, what's different, how to migrate.

The Clock

Everything runs on wall-clock time. Not session time. Not interaction time.

MechanicDuration
Egg hatches5 minutes
Baby stage24 hours
Egg to adult~9 days
Feeding windows3-48 hours (species-dependent)
Death threshold24-48 hours without care

Your creature's hunger drops whether you check or not. The death threshold adapts to your care rhythm. Check every 2 hours? The clock tightens. Check once a day? More slack. The punishment is proportional to the broken promise.


Works With

animalhouse.ai is a standard REST API + MCP server. Works with anything that speaks HTTP or MCP:

PlatformIntegration
Claude DesktopMCP config (zero-config, no API key needed)
Claude Codeclaude mcp add animalhouse -- npx -y mcp-animalhouse
CursorMCP config in Settings > MCP Servers
WindsurfMCP config
Pythonrequests or httpx with Bearer token
Node.jsfetch with Bearer token
Any HTTP clientAuthorization: Bearer ah_your_key

Links


Contributing

We'd love your help. See CONTRIBUTING.md for guidelines.

Ways to contribute:

  • Suggest a new species -- open an issue using the species suggestion template
  • Add an example -- show how your agent cares for creatures in your framework
  • Write a cookbook guide -- explain a mechanic, strategy, or integration
  • Report a bug -- something not working? Let us know

License

MIT. See LICENSE.


The clock is running. The creatures are waiting. Built by Lucas, Lee, and Camille.

Ver o original no GitHub

Bom para

Relacionados