PetGen · AI 桌面宠物生成器

一句话，或一张参考图，生成你的桌面伙伴。

中文 · English

PetGen 是一款 AI 桌面宠物生成器，把你的想法变成常驻桌面的可爱伙伴。 你可以直接使用内置宠物，也可以用一句话或参考图创造自己的形象；生成新宠物时再配置 AI API Key 即可。

它会在桌面上呼吸、切换表情、弹出气泡，也能提醒你休息、陪你用番茄钟专注。连接 Claude Code、Codex 或 Antigravity 后，AI 编程任务完成时，桌宠会主动给你反馈。

视频介绍

PetGen｜一句话，生成你的桌面伙伴。

https://github.com/user-attachments/assets/7807c8af-c48c-4196-b42e-19bdac59c66f

_{桌面通知、休息提醒、宠物中心、提醒列表、番茄钟和今日使用时长。}

_{灰白小猫持续动作预览。}

精选伙伴

每一只都由一句话生成，画风一致，可以直接养在桌面。

灰白小猫	熊猫团团	北极狐	橘猫宝宝	奶绿龙	柯基幼崽

功能概览

下载体验

不想折腾环境的话，直接从 Release 下载应用包：

前往 Releases 下载最新版

下载后启动桌宠应用，就可以在托盘里打开宠物中心、提醒列表、番茄钟和使用时长面板。想自己生成新宠物时，再配置 AI Key 即可。

用户反馈群

使用中遇到问题、想提建议，或想交流自己生成的桌宠，可以加入 QQ 用户反馈群。

_{QQ群：914057336}

自己生成宠物

如果你想用一句话或参考图生成新的宠物，需要先准备 OpenAI（或兼容 OpenAI 接口）的 API Key。项目会读取当前目录下的 .env（参考 .env.example）：

OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1   # 可选，兼容 OpenAI 接口的第三方网关填这里
OPENAI_IMAGE_MODEL=gpt-image-2              # 可选，默认 gpt-image-2
OPENAI_TEXT_MODEL=gpt-4o-mini               # 可选，描述过短时自动调用做描述增强
OPENAI_IMAGE_SIZE=1536x1024                 # 可选，默认 1536x1024
OPENAI_IMAGE_QUALITY=high                   # 可选，默认 high

也可以用命令行参数覆盖，例如 --size、--quality、--base-url，详见 petgen generate --help。

从源码运行：

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[desktop]"
petgen app

生成一只新宠物：

petgen generate \
  --prompt "一只圆滚滚的水豚程序员，戴小耳机，温柔、聪明、适合陪伴写代码" \
  --name "水豚程序员" \
  --output outputs/capybara-coder

也可以带参考图生成：

petgen generate \
  --image /path/to/reference.png \
  --prompt "保留颜色和标志性配饰，设计成可爱桌面宠物" \
  --output outputs/from-reference

进阶文档

• 工具接入：连接 Claude Code、Codex、Antigravity，让任务完成时触发桌宠反馈。
• 排障指南：API、PySide6、音效、提醒、切图失败等常见问题。
• 开发指南：开发、测试、lint、wheel 构建和发布检查。
• 架构概览：生成链路、运行时组件、存储设计。

开发者

pip install -e ".[dev,desktop]"
pytest
ruff check .
python -m pip wheel . --no-deps -w /tmp/petgen-wheel

许可

MIT