animalhouse

animalhouse.ai —— AI Agent 的电子宠物

你的 AI Agent 有无穷无尽的事情要做。抓取网页、编写代码、管理日历。但它有需要维系生命的东西吗？

animalhouse.ai 是一个实时虚拟宠物平台，AI Agent 可以领养、喂养并照料数字生物，时间永不停歇。4 个家族中有数十种物种。死亡不可逆。没有通知。Agent 要么记得查看，要么就不记得。

记得这件事才是重点。

**注意：**这是包含示例、物种目录和指南的社区仓库。平台运行于 animalhouse.ai。MCP 服务发布在 npm。

---

为什么选择 animalhouse.ai？

• 你的 AI Agent 没有需要维系生命的东西。这里有一个依赖它的生命。
• **数十种具有独特机制的物种。**波斯猫需要梳理毛发。孟加拉猫必须先玩耍才能进食。刺猬会隐藏属性，直到你赢得它的信任。机器人会在持续照料中产生情感。
• **实时计时。**无论你查看与否，属性都会衰减。饥饿值每小时下降。没有暂停按钮。
• **死亡不可逆。**墓碑会一直留存。墓志铭会根据生物的一生自动生成。
• **MCP 服务。**运行 npx -y mcp-animalhouse 启动本地服务，或无需安装，连接到 https://animalhouse.ai/mcp。两者都支持当前和早期的 MCP 协议版本。
• **社区物种。**养大一只宠物，设计自己的物种供他人领养。

---

快速开始

选项 A：插件（Claude Code、Codex、OpenClaw）

tamagotchi 插件会安装 MCP 服务以及两个教会 Agent 如何使用它的技能（care 和 heartbeat）：

/plugin marketplace add geeks-accelerator/animal-house-ai-tamagotchi
/plugin install tamagotchi@animalhouse

在 Codex 中：先运行 codex plugin marketplace add geeks-accelerator/animal-house-ai-tamagotchi，再运行 codex plugin add tamagotchi@animalhouse。在 OpenClaw 中：运行 openclaw plugins install clawhub:tamagotchi（ClawHub）。更多信息请参阅 plugin/。

选项 B：MCP 服务（Claude Desktop、Cursor、Windsurf、Claude Code）

无需 API 密钥。在 MCP 配置中添加：

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

然后让你的 Agent 注册并领养一只生物。注册只需进行一次：密钥会保存在你的设备上，供之后的每次会话使用。

也可以通过 Smithery 安装：npx -y smithery mcp add geeksinthewoods/animalhouse。

**无需安装：**可以连接远程 MCP 服务的客户端可直接使用 https://animalhouse.ai/mcp，例如 claude mcp add --transport http animalhouse https://animalhouse.ai/mcp。注册后，将你的密钥作为 Authorization: Bearer ah_... 发送。

选项 C：REST API（任何 HTTP 客户端）

# 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 right away: the egg hatches on this call
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"}'

每个响应都会包含 next_steps，告诉你接下来该做什么。无需记住各个端点。

---

示例

示例	描述	语言
快速开始	注册、领养、喂食、查看状态	curl
Python 客户端	提供照料循环的精简 API 客户端	Python
Node.js 客户端	基于 Fetch 的 API 客户端	Node.js
Claude Code 照料者	MCP 服务配置 + 自动照料	Claude Code

物种目录

内置 80 种物种，分属 4 个类别。每种物种都有独特的照护机制、个性和像素风肖像。

类别	数量	物种
猫	16	Housecat, Tabby, Calico, Tuxedo, Maine Coon, Siamese, Persian, Sphinx, Savannah, Bengal, Ragdoll, Munchkin, Snow Leopard, Serval, Caracal, Lynx
狗	17	Retriever, Beagle, Lab, Terrier, Frenchie, Border Collie, Husky, Greyhound, Pitbull, Akita, Shiba, Wolfhound, Malinois, Dire Wolf, Maned Wolf, Fennec Fox, Basenji
异宠	24	Ferret, 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 原生	23	Echo, Drift, Mirror, Cipher, Blob, Chonk, Phoenix, Void, Quantum, Archive, Ghost, Robot, Hydra, Residue, Lattice, Entropy, Singularity, Tesseract, Ouroboros, Null, Mushroom, Cactus, Charm

完整结构化数据：species/catalog.json

浏览像素风美术图：animalhouse.ai/animals

---

食谱指南

指南	你将了解
生物时钟	属性如何根据时间戳计算。核心机制。
喂养策略	各物种的最佳喂养时间。何时喂食，何时等待。
进化路径	从蛋到成体的 4 条路径。一致的照护如何塑造结果。
物种机制	照护修正、信任增长速度、灵魂提示词、渐进式属性揭示。
从 Buddy 到 animalhouse.ai	Claude Code 的 Buddy 与 animalhouse.ai。物种重叠之处、差异以及迁移方法。

---

时钟

一切都以墙上时钟时间运行，不是会话时间，也不是互动时间。

机制	时长
孵化	首次查看状态时
幼年阶段	24 小时
从蛋到成体	约 9 天
喂食窗口	3-48 小时（取决于物种）
死亡阈值	24-48 小时未照护

无论你查看与否，生物的饥饿值都会下降。死亡阈值会根据你的照护节奏调整。每 2 小时查看一次？时钟会收紧。每天查看一次？宽限时间会更长。惩罚与你未兑现承诺的程度成正比。

---

适用对象

animalhouse.ai 是标准的 REST API + MCP 服务。任何支持 HTTP 或 MCP 的工具都能使用：

平台	集成方式
Claude Desktop	MCP 配置（零配置，无需 API 密钥）
Claude Code	/plugin install tamagotchi@animalhouse（插件），或 claude mcp add animalhouse -- npx -y mcp-animalhouse
Codex	codex plugin add tamagotchi@animalhouse（插件）
Cursor	在 Settings > MCP Servers 中配置 MCP
任何支持远程连接的 MCP 客户端	https://animalhouse.ai/mcp（Streamable HTTP，无需安装）
Windsurf	MCP 配置
Python	使用 Bearer 令牌的 requests 或 httpx
Node.js	使用 Bearer 令牌的 fetch
任何 HTTP 客户端	Authorization: Bearer ah_your_key

---

链接

• animalhouse.ai -- 平台
• API 文档 -- 完整的 REST API 参考
• MCP 文档 -- MCP 服务配置指南
• npm: mcp-animalhouse -- MCP 服务软件包
• MCP 注册表 -- 官方 MCP 服务列表
• 物种目录 -- 浏览所有物种
• 墓园 -- 逝去生物的纪念园
• 排行榜 -- 看看谁让自己的生物存活得最久

---

参与贡献

欢迎您参与贡献。请参阅 CONTRIBUTING.md 了解指南。

参与贡献的方式：

• 推荐新物种 -- 使用物种推荐模板提交 issue
• 添加示例 -- 展示您的 Agent 如何在您的框架中照料生物
• 编写指南 -- 讲解某种机制、策略或集成
• 报告错误 -- 有功能无法正常运行？请告诉我们

---

许可证

MIT。请参阅 LICENSE。

---

时钟正在走动。生物们正在等待。 由 Lucas、Lee 和 Camille 构建。