Skip to content

Latest commit

 

History

157 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages