Pumpet

The first Codex Pet with direct PumpFun integration.

OpenAI's Codex /hatch flow makes it possible to create your own agent pets. With Pumpet, you can hatch a pet, talk to it, train it, and build new behaviors.

---

Core idea

• Create an agent pet with /hatch
• Develop and train your pet in Codex
• Plug in direct PumpFun integration from this repository

If you want the full setup, clone this repo, open it in Codex, and follow the install steps below.

---

Install in Codex

1. Clone the repository:

git clone https://github.com/TickyPrincess/pumpet.git
cd pumpet

2. Install dependencies:

pnpm install

3. Start development:

pnpm dev

4. (Optional) Hatch command example:

/hatch goblin pet

---

Useful commands

pnpm test
pnpm build
docker compose up --build

Local URLs:

• Web: http://localhost:5173
• API health: http://localhost:3000/health

---

Repository structure

• apps/web — React + Vite + TypeScript UI
• apps/api — Fastify API
• packages/shared — shared schemas/types
• packages/agent-core — Goblin pet behavior engine
• .github/workflows — CI + GitHub Pages deploy
• infra — Docker and runtime config

---

Live demo

• GitHub Pages: https://tickyprincess.github.io/pumpet/

---

Deployment

• Web: GitHub Pages / Vercel / Netlify
• API: Railway / Render / Fly.io / Docker host
• Full stack: Docker Compose

More details: docs/deployment.md

---

License

MIT