龙宝 Longbao — Chinese Dragon Animated Pet for OpenAI Codex

龙宝（Longbao）是一款可安装到 OpenAI Codex 的开源中国龙动画宠物。
An open-source Chinese dragon animated desktop pet / mascot for OpenAI Codex, featuring 9 application states, 16 gaze directions, transparent sprite artwork, and a validated Codex v2 sprite sheet.

Animations

Waving	Jumping	Waiting
Working	Reviewing	Oops!
Idle	Moving Right	Moving Left

Full animation sheet

Why Longbao?

Longbao combines the silhouette of a traditional Chinese dragon with a compact, friendly chibi sticker style designed for small desktop-pet rendering:

• teal-green serpentine dragon body
• golden antlers and belly scales
• red mane and connected whiskers
• friendly, expressive face
• transparent background with crisp sprite edges
• complete clockwise 16-direction look animation

如果你正在搜索 Codex 宠物、中国龙桌面宠物、OpenAI Codex mascot、animated sprite pet、Chinese dragon sprite sheet，这个仓库提供了可以直接安装、学习和二次创作的完整示例。

Features

• Codex sprite contract version: v2
• Atlas size: 1536 × 2288
• Grid: 8 columns × 11 rows
• Cell size: 192 × 208
• Standard animation states:
  • idle
  • running right
  • running left
  • waving
  • jumping
  • failed / blocked
  • waiting for user input
  • active task work
  • review
• 16 clockwise look directions from 000 up through 337.5 up-left
• Transparent WebP sprite sheet
• Deterministic atlas and chroma-edge validation
• Three-reviewer blind direction QA with every pair passing

Direction preview

Install in Codex

Windows PowerShell

$destination = Join-Path $HOME ".codex\pets\longbao"
New-Item -ItemType Directory -Force -Path $destination | Out-Null
Copy-Item .\pet\pet.json, .\pet\spritesheet.webp -Destination $destination -Force

macOS or Linux

mkdir -p ~/.codex/pets/longbao
cp pet/pet.json pet/spritesheet.webp ~/.codex/pets/longbao/

Restart or reload Codex after installation if the pet does not appear immediately.

Repository structure

.
├── assets/
│   ├── animation-contact-sheet.png
│   ├── longbao-character-reference.png
│   └── look-directions.png
├── pet/
│   ├── pet.json
│   └── spritesheet.webp
├── previews/
│   └── *.gif
├── qa/
│   ├── atlas-validation.json
│   ├── direction-blind-validation.json
│   ├── direction-semantics.json
│   └── look-continuity.json
├── CONTRIBUTING.md
├── LICENSE
└── README.md

Animation map

Row	State	Frames	Purpose
0	idle	6	breathing and blinking
1	running-right	8	rightward drag movement
2	running-left	8	leftward drag movement
3	waving	4	greeting
4	jumping	5	playful jump
5	failed	8	blocked or failed reaction
6	waiting	6	waiting for approval or input
7	running	6	active task processing
8	review	6	reviewing completed work
9	look 000–157.5	8	up through down-right
10	look 180–337.5	8	down through up-left

Validation

The packaged atlas passes the Codex v2 validator:

• RGBA WebP
• exact 1536 × 2288 dimensions
• spriteVersionNumber: 2
• populated required cells
• transparent unused cells
• zero transparent RGB residue
• no atlas validation errors or warnings
• all horizontal and vertical blind direction pairs passed unanimously

Machine-readable results are available in qa/.

Customization

You may remix the palette, expression, markings, or character design under the MIT License. Keep these technical constraints when building a compatible variant:

1. Preserve the 8 × 11 atlas layout.
2. Keep each cell at 192 × 208.
3. Use transparency outside the pet silhouette.
4. Preserve the required frame counts.
5. Keep all 16 directions in clockwise order.
6. Set spriteVersionNumber to 2 in pet.json.

Search keywords

OpenAI Codex pet, Codex animated pet, Codex mascot, Chinese dragon pet, 中国龙宠物, 龙桌面宠物, animated desktop pet, sprite sheet mascot, Chinese dragon sprite, chibi dragon animation, open-source Codex customization.

License and attribution

Released under the MIT License. The character artwork and animation assets were created with AI-assisted image generation and iterative human-directed QA. “OpenAI” and “Codex” are trademarks of their respective owner; this community project is not an official OpenAI product.

Contributions and compatible pet variants are welcome—see CONTRIBUTING.md.