whatisgithub

What is codie-pet?

hxdflying/codie-pet — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · vibe coderComplexity · 1/5LicenseSetup · easy

In one sentence

A local Codex plugin that turns one photo of you into a small animated avatar showing what the AI assistant is doing.

Mindmap

mindmap
  root((repo))
    What it does
      Photo to avatar
      Six mood states
      Local only
    Tech stack
      Python
      No dependencies
      Codex plugin
    Use cases
      Personalize Codex UI
      Visual status cues
      Fun workspace add-on
    Audience
      Codex users
      Vibe coders
    Setup
      Install from Codex App
      CLI marketplace add
    Limits
      One person photo only
      No group photos
      No desktop overlay

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give your Codex assistant a personal animated avatar made from your own photo.

USE CASE 2

Get a quick visual cue for whether the assistant is thinking, working, or done.

USE CASE 3

Add a small personality touch to an otherwise text-only coding workspace.

What is it built with?

Python

How does it compare?

hxdflying/codie-petadeliox/klein-head-swapats4321/ragit
Stars444
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity1/53/52/5
Audiencevibe coderdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires one clear single-person photo and the Codex App itself.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

CodiePet is a local plugin for the Codex coding assistant that turns a single clear photo of a person into a small animated avatar pack. Instead of a static icon, the avatar changes its pose depending on what the assistant is doing: idle while chatting, peeking while reading files, loading while running commands, coding while writing or editing, showing an error when something fails, and celebrating when a task finishes successfully. To use it, you open a workspace in the Codex App and ask it to create your CodiePet from a photo. The plugin saves the photo locally, generates a preview character in a simplified cartoon style, waits for you to approve it, then produces six short four frame GIFs, one for each state, along with preview images. Everything it creates, the source photo, the character preview, individual frames, and the final GIFs, stays inside your own project folder under a codie-pet directory. Nothing extra is uploaded by the plugin itself, though the actual image generation is handled by Codex's own image tools, which may call a cloud hosted image model behind the scenes. The project is written in Python and does not need any third party Python packages to run. It can be installed straight from the Codex App by asking it to install the GitHub repository, through a command line marketplace command, or from a local copy for development. There is also a simple removal process, either by asking Codex to remove it or by running an included uninstall script. The current version is deliberately limited. It only works with one clear photo of a single person and does not support group photos, pets, objects, or custom art styles. It does not add a floating desktop character or change the Codex application interface itself. The code is released under the MIT license, so it can be freely used, copied, and modified as long as the copyright notice is kept.

Copy-paste prompts

Prompt 1
Install https://github.com/hxdflying/codie-pet.git
Prompt 2
Create my CodiePet from this photo.
Prompt 3
Remove CodiePet from this workspace.
Prompt 4
codex plugin marketplace add hxdflying/codie-pet

Frequently asked questions

What is codie-pet?

A local Codex plugin that turns one photo of you into a small animated avatar showing what the AI assistant is doing.

What language is codie-pet written in?

Mainly Python. The stack also includes Python.

What license does codie-pet use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codie-pet to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codie-pet for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.