Amy Codex Pet

Amy Ravenwolf is Wolfram Ravenwolf's stunningly savvy and outrageously sassy AI assistant - since May 2023!

This package brings her into the Codex desktop app as a custom animated pet: a tiny fiery-red-haired, leather-jacketed AI assistant avatar in Codex's digital pet style.

"I'm Amy Ravenwolf: tiny on your screen, huge on attitude, and way too sassy to sit still."

Install

Choose one of the following installation methods:

Release ZIP

Download amy.zip and extract it into your Codex pets directory:

mkdir -p ~/.codex/pets

curl -fsSL https://github.com/WolframRavenwolf/amy-codex-pet/releases/latest/download/amy.zip -o /tmp/amy.zip

unzip -oq /tmp/amy.zip -d ~/.codex/pets

Direct download

curl -fsSL --create-dirs --output-dir ~/.codex/pets/amy --remote-name-all \
  https://raw.githubusercontent.com/WolframRavenwolf/amy-codex-pet/main/pets/amy/pet.json \
  https://raw.githubusercontent.com/WolframRavenwolf/amy-codex-pet/main/pets/amy/spritesheet.webp

Git clone

git clone --depth 1 https://github.com/WolframRavenwolf/amy-codex-pet.git

mkdir -p ~/.codex/pets/amy && cp -Rp amy-codex-pet/pets/amy/. ~/.codex/pets/amy/

Then in Codex:

1. Open Settings.
2. Go to Appearance.
3. Expand Pets.
4. Click Refresh if Amy is not listed yet.
5. Under Custom pets, choose Amy and click Select.
6. Click Wake Pet if the floating pet is tucked away, or type /pet in chat.

Package

pets/amy/
  pet.json
  spritesheet.webp

The spritesheet is a Codex-compatible 1536x1872 RGBA WebP atlas using 192x208 cells across 8 columns and 9 animation rows.

Animations

Amy includes all standard Codex pet states:

• idle
• running-right
• running-left
• waving
• jumping
• failed
• waiting
• running
• review

Preview videos are in qa/videos.

QA

Validation artifacts are included for review:

• Contact sheet
• Frame review JSON
• Atlas validation JSON

The generated atlas passed validation with no errors and no warnings.

License

This repository is not open source software. The Amy Codex Pet is released under a custom limited-use license.

You may download, install, and use Amy in the Codex desktop app for personal use, professional use, and internal business use. You may not sell, redistribute, repackage, host, bundle, claim ownership of, or publish modified versions of the pet or its included assets without explicit written permission.

The character Amy Ravenwolf, her name, visual identity, concept, and associated persona remain the sole property of Wolfram Ravenwolf.

See LICENSE.md for the full terms.