Tutoriel : créer sa propre mascotte de bureau Codex

Mis à jour le 2026-07-16 · version vérifiée sur les usages officiels

Les mascottes de Codex App ne se limitent pas à celles fournies d'origine. OpenAI a laissé une porte d'entrée complète pour la personnalisation : préparez un spritesheet conforme et un pet.json, déposez-les dans le bon dossier, et n'importe quel personnage de votre cru peut habiter votre bureau. Encore plus simple : OpenAI propose une compétence baptisée hatch-pet à qui vous lancez quelques images de référence, et qui dessine toute l'animation à votre place. Cet article détaille les deux voies, avant de conclure sur un cas réel : comment deux memes de capybara sont devenus une mascotte fonctionnelle.

Est-ce bien un usage officiel ?

Oui. hatch-pet figure dans le dossier curated (la sélection) du dépôt officiel de compétences d'OpenAI, openai/skills, et les specs de la toile, les 9 lignes d'états d'animation, le nombre d'images et la durée de chaque ligne sont figés par les fichiers de contrat officiels. Un point à noter : ce dépôt est désormais marqué comme migré, le nouvel écosystème de compétences se trouvant sur openai/plugins — mais hatch-pet reste installable et utilisable à son emplacement d'origine.

La mascotte elle-même est plus simple que la plupart des gens ne l'imaginent : deux fichiers, pas un de plus.

~/.codex/pets/votre-id-de-mascotte/
├── pet.json          # métadonnées : 4 champs
└── spritesheet.webp  # spritesheet 1536×1872 (PNG accepté)

Nous avons résumé le détail des specs (combien d'images par ligne d'animation, quelles cases doivent rester transparentes) dans un tableau de référence : voir les specs du spritesheet en détail.

Voie 1 : hatch-pet, laisser l'IA dessiner

Pour qui veut un rendu dessiné à la main soigné et utilise déjà Codex App. Prérequis : la compétence officielle de génération d'images doit être installée dans Codex ($imagegen, généralement fournie d'origine dans les versions récentes).

1. Installation : tapez $skill-installer hatch-pet dans une conversation Codex, puis redémarrez Codex ;
2. Formuler la demande : dites simplement « fais-moi éclore une mascotte ___ ». Une description textuelle suffit, mais vous pouvez joindre des images de référence : votre mascotte maison, un croquis, voire une photo d'animal. Styles possibles : pixel (pixel art), plush (peluche), clay (pâte à modeler), sticker (autocollant), 3d-toy (jouet 3D)… sans précision, le style est déduit automatiquement ;
3. Laisser travailler : hatch-pet produit d'abord une image de référence à valider, puis génère ligne par ligne les 9 animations (repos, course à gauche et à droite, salut, saut, échec, attente, travail, relecture), assemble automatiquement la grande image 1536×1872, détoure le fond et lance le script de validation ;
4. Activation : le résultat atterrit directement dans ~/.codex/pets/, il n'y a plus qu'à le sélectionner dans les réglages des mascottes.

Conseils pratiques pour les images de référence : 1 à 3 images à la fois, personnage entier, fond propre — c'est ce qui marche le mieux. Demandez explicitement « le même visage, la même palette » sur toutes les lignes d'animation : c'est le critère au poids le plus élevé dans les standards QA officiels.

Voie 2 : dessiner image par image en code

Pour qui ne veut pas jouer à la loterie et exige un contrôle à 100 %. Les 91 mascottes de ce site sont générées par programme avec Python + Pillow : le corps est composé d'aplats de couleur sur une petite grille, chaque image reçoit ses paramètres selon l'état, puis le tout est assemblé au format requis. Une fois le moteur de dessin écrit, ajouter une mascotte ne demande plus que dix lignes de configuration. La démarche complète et le découpage des images sont détaillés dans le chapitre du guide consacré à la fabrication maison.

En pratique : deux memes, une mascotte

Un lecteur nous a envoyé deux memes de capybara en demandant « on peut faire ça aussi ? ». Oui — et c'est exactement le processus standard de la création d'après photo. Notre méthode tient en trois étapes :

1. Extraire des traits, pas décalquer : ce que l'on tire des images de référence, c'est une liste de caractéristiques — corps rond couleur thé au lait, museau en ovale sombre occupant la moitié du visage, petites oreilles rondes, joues rosées, posture globalement avachie, contour brun chaud ;
2. Redessiner d'après ces traits : avec cette liste, on dessine un capybara original sur la grille de pixels, sur les 9 lignes d'animation (même en mode avachi, le saut est pris au sérieux) ;
3. Passer la validation officielle : on vérifie dimensions, nombre d'images et transparence avec validate_atlas.py du dépôt officiel — tout doit être vert avant publication.

Le résultat s'appelle Paka le capybara avachi : sa page permet de prévisualiser directement les 9 états et de le télécharger gratuitement.

Les cinq pièges classiques

• Le nombre d'images varie selon la ligne : 6 pour le repos, 4 pour le salut, 5 pour le saut, 8 pour la course et l'échec, 6 pour le reste — les cases dessinées en trop doivent être intégralement transparentes, sinon la validation échoue ;
• Ne pas dépasser du cadre en sautant : la mascotte entière (oreilles et chapeau compris) doit tenir dans les 192×208 sur chaque image ;
• Une transparence propre : pas d'ombre semi-transparente, pas d'ombre portée au sol, pas de lignes de vitesse, et aucune valeur RVB résiduelle cachée dans les pixels transparents ;
• La hiérarchie des dossiers : pet.json doit se trouver directement dans pets/id-de-la-mascotte/ ; le dossier intermédiaire ajouté à la décompression est la cause la plus fréquente du « la mascotte n'apparaît pas » ;
• La ligne working n'est pas de la course : la doc officielle est claire, cette ligne exprime « concentré sur son travail » ; une mascotte qui court à grandes enjambées sera recalée.

Le tableau de specs complet (avec la durée officielle de chaque ligne) se trouve ici.

Pas envie de mettre les mains dedans ?

Le site en propose déjà 91 : 50 du catalogue original + 41 de la série inspirations, toutes passées par le script de validation officiel, gratuites et modifiables à volonté. Chaque fiche fournit une commande d'installation PowerShell d'une seule ligne : 30 secondes suffisent pour installer le capybara ou le chat cyber sur votre bureau.