Skip to content

Repository files navigation

Codex Pet Generator

Codex Pet Generator

Turn any photo into a custom animated pixel pet for OpenAI Codex Desktop.
Try it live →

Blog · Pricing · FAQ

Next.js Supabase TypeScript TailwindCSS MIT


What It Does

Upload a photo of your pet (or any image), and AI generates a ready-to-install animated pixel pet for OpenAI Codex Desktop. The output is a ZIP containing a spritesheet and metadata file -- drop it into your Codex pets folder and your new companion comes to life.

Try it free: codexpetgenerator.com -- no credit card required.

Features

  • Upload any photo -- JPG, PNG, WebP, up to 10MB
  • AI pixel art generation -- powered by Qwen-Image or OpenAI
  • 9 animation states -- idle, walk, run, jump, sleep, die, action, special, interact
  • Full spritesheet + JSON -- Codex-compatible format, ready to install
  • Animation preview -- see your pet move before downloading
  • One-click install commands -- for macOS and Windows
  • Free to try -- Starter plan included, Pro for HD and more generations

Quick Start (local dev)

git clone https://github.com/863683348/codex-pet-generator.git
cd codex-pet-generator
cp .env.example .env.local
npm install
npm run dev

Open http://localhost:3000.

Tech Stack

Layer Technology
Framework Next.js 15 (App Router)
Database Supabase (PostgreSQL + Storage)
AI Qwen-Image (Bailian) / OpenAI Images API
Styling TailwindCSS 3
Image Processing Sharp
Payment Creem
Deployment Vercel

How It Works

  1. Upload your image to the web app
  2. AI generation creates a pixel art base character (~90 seconds)
  3. Review and approve the base design (or regenerate)
  4. Animation generation creates 9 animation states (~2-5 minutes)
  5. Download the ZIP package containing spritesheet.webp + pet.json
  6. Install to ~/.codex/pets/ and restart Codex

Blog

Read our guides and tutorials:

Deploy to Vercel

  1. Import the repo from GitHub at vercel.com
  2. Add all environment variables from .env.example to Vercel's Settings
  3. Set NEXT_PUBLIC_SITE_URL to your production domain
  4. Deploy

Note: The animation generation step requires up to 300 seconds. Vercel Hobby plan caps at 60s -- the Pro plan ($20/mo) is needed for full functionality.

License

MIT


Made with ❤ for the Codex community

About

Upload a photo, get a pixel-art Codex pet with 9 animation states + installable spritesheet/webp/zip

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages