Tutorial: crea tu propia mascota de escritorio para Codex

Actualizado el 2026-07-16 · Versión con la vía oficial verificada

Las mascotas de Codex App no se limitan a las que vienen incluidas. La vía oficial de personalización está totalmente abierta: prepara un spritesheet que cumpla la especificación y un pet.json, colócalos en la carpeta de tu equipo y cualquier personaje que dibujes podrá vivir en tu escritorio. Y aún más cómodo: OpenAI ha publicado una habilidad llamada hatch-pet a la que le pasas unas imágenes de referencia y te dibuja todas las animaciones. Aquí explicamos las dos vías y cerramos con un caso real: cómo dos stickers de capibara acabaron convertidos en una mascota funcional.

¿Es esta la vía oficial?

Sí. hatch-pet está en el directorio curated (la selección oficial) del repositorio de habilidades de OpenAI, openai/skills, y el tamaño del lienzo, las 9 filas de estados de animación y los fotogramas y duraciones de cada fila están fijados por los archivos de contrato oficiales. Un detalle a tener en cuenta: ese repositorio ya aparece marcado como migrado y el nuevo ecosistema de habilidades vive en openai/plugins, pero hatch-pet sigue estando donde estaba y se puede instalar y usar sin problema.

Una mascota es más sencilla de lo que casi nadie espera: dos archivos y ya está.

~/.codex/pets/id-de-tu-mascota/
├── pet.json          # metadatos con 4 campos
└── spritesheet.webp  # spritesheet de 1536×1872 (PNG también vale)

Los detalles de la especificación (cuántos fotogramas usa cada fila de animación, qué celdas tienen que quedar transparentes) los hemos recogido en una tabla de consulta rápida: mira la especificación del spritesheet al detalle.

Vía uno: hatch-pet, que dibuje la IA por ti

Es la opción de quien busca un acabado cuidado de dibujo a mano y ya usa Codex App. Requisito: tener instalada en Codex la habilidad oficial de generación de imágenes ($imagegen, que en las versiones nuevas suele venir de serie).

1. Instalación: escribe $skill-installer hatch-pet en la conversación de Codex y reinicia Codex al terminar;
2. Pide lo que quieres: dilo sin más, «incúbame una mascota ___». Puedes darle solo una descripción de texto o adjuntar imágenes de referencia: la mascota de tu empresa, un boceto a mano o incluso la foto de tu mascota real. Los estilos disponibles son pixel, plush (peluche), clay (plastilina), sticker (pegatina), 3d-toy (juguete 3D) y alguno más; si no indicas ninguno, lo deduce solo;
3. Déjala trabajar: hatch-pet genera primero una imagen base para que la confirmes y después dibuja fila a fila las 9 animaciones (reposo, correr a izquierda y derecha, saludo, salto, error, espera, trabajo y revisión), las monta automáticamente en la imagen de 1536×1872, recorta el fondo transparente y pasa el script de validación;
4. Actívala: el resultado cae directamente en ~/.codex/pets/; solo tienes que seleccionarlo en los ajustes de mascotas.

Consejos prácticos para las imágenes de referencia: lo que mejor funciona es darle entre 1 y 3 imágenes, con el personaje de cuerpo entero y el fondo limpio. Y pídele que mantenga «la misma cara y la misma paleta» en todas las filas de movimiento: es el criterio con más peso del estándar de QA oficial.

Vía dos: dibujarla con código, fotograma a fotograma

Esta es la vía de quien no quiere jugar a la ruleta y prefiere un control del 100 %. Las 91 mascotas de este sitio están generadas por programa con Python + Pillow: montamos el cuerpo con bloques de color sobre una rejilla pequeña, parametrizamos cada fotograma según el estado y al final componemos la imagen grande con la especificación. Una vez escrito el motor de dibujo, añadir una mascota nueva cuesta diez líneas de configuración. El planteamiento completo y el diseño de fotogramas están en el capítulo de creación propia de la guía.

En la práctica: dos stickers, una mascota

Un lector nos envió dos stickers de capibara preguntando si «con esto también se podía». Se puede, y de hecho es justo el proceso estándar de personalización a partir de imágenes. Nosotros lo hacemos en tres pasos:

1. Extraer rasgos, no calcar: de las imágenes de referencia sacamos una lista de rasgos: cuerpo redondo color té con leche, óvalo oscuro del hocico ocupando media cara, orejitas redondas, coloretes, postura general de tumbado con desgana y contorno marrón cálido;
2. Redibujar a partir de los rasgos: con esa lista dibujamos un capibara original sobre la rejilla de píxeles, con sus 9 filas de animación (y sí, aunque sea de los tumbados, el salto lo hace en serio);
3. Pasar la validación oficial: comprobamos tamaño, número de fotogramas y transparencia con el validate_atlas.py del repositorio oficial, y solo la publicamos con todo en verde.

El resultado se llama Paka el capibara tumbado, y en su página puedes previsualizar los 9 estados y descargarla gratis.

Los cinco puntos donde más se falla

• Cada fila lleva un número distinto de fotogramas: reposo 6, saludo 4, salto 5, correr y error 8, y el resto 6. Las celdas de más tienen que quedar completamente transparentes o no pasarás la validación;
• El salto no puede salirse de la celda: la mascota entera (orejas y sombreros incluidos) tiene que caber dentro de los 192×208 en todos y cada uno de los fotogramas;
• La transparencia tiene que estar limpia: nada de sombras semitransparentes, sombras en el suelo ni líneas de velocidad, y los píxeles transparentes tampoco pueden esconder valores RGB residuales;
• La estructura de carpetas: pet.json tiene que estar directamente dentro de pets/id-de-la-mascota/; la carpeta de más que aparece al descomprimir es la causa más habitual de que «la mascota no aparezca»;
• La fila working no es correr: la especificación oficial dice que esta fila representa «concentración en el trabajo», así que dibujarla como una carrera con zancadas se considera no conforme.

La tabla de especificación completa (con las duraciones oficiales de cada fila) está aquí.

¿No te apetece ponerte a ello?

Aquí tienes 91 listas para usar: 50 del catálogo original + 41 de la serie inspiración, todas validadas con el script oficial, de descarga gratuita y libres de modificar. Cada ficha trae su comando de instalación de una línea para PowerShell: en 30 segundos puedes tener al capibara o al gato ciberpunk viviendo en tu escritorio.