codex-pokepets

Codex PokéPets

Every Pokémon as a Codex pet, sourced from existing animated sprites. No AI generation, no re-drawing.

• 2D pixel-art: 649 Gen 1–5 Pokémon plus 85 alt forms
• 3D animated: 1004 Gen 1–9 Pokémon (use -3d suffix)

Install

Install one or more pets directly into ~/.codex/pets/ without cloning anything. Just type the Pokémon’s name:

curl -fsSL https://raw.githubusercontent.com/dnnyngyen/codex-pokepets/main/install-pet.sh | bash -s -- charizard

3D variants use the -3d suffix (charizard-3d). Forms use PokeAPI’s hyphen convention (deoxys-attack, unown-z, arceus-fire).

For the 3D animated version, add -3d:

curl -fsSL https://raw.githubusercontent.com/dnnyngyen/codex-pokepets/main/install-pet.sh | bash -s -- charizard-3d

Pokémon with alternate forms (Rotom, Unown, Arceus, etc.) install all their forms together by default:

curl -fsSL https://raw.githubusercontent.com/dnnyngyen/codex-pokepets/main/install-pet.sh | bash -s -- rotom

For one specific form, type the form’s full name:

curl -fsSL https://raw.githubusercontent.com/dnnyngyen/codex-pokepets/main/install-pet.sh | bash -s -- rotom-wash

Gen 6+ Pokémon (Cinderace, Gholdengo, Koraidon, etc.) only have a 3D version, so the bare name installs that automatically — no -3d needed.

Install several at once by listing them:

curl -fsSL https://raw.githubusercontent.com/dnnyngyen/codex-pokepets/main/install-pet.sh | bash -s -- charizard mewtwo lucario garchomp

Then restart Codex and pick your pet in Settings → Appearance → Pets. To uninstall: rm -rf ~/.codex/pets/<slug>.

Featured pets

2D (Gen 1–5, PokeAPI BW animated)

Featured: charizard, lucario, rayquaza, garchomp, umbreon, gengar, mewtwo, tyranitar, bulbasaur, lugia, chandelure, pikachu, eevee, luxray, zoroark, flygon.

3D (Gen 1–9, Pokemon Showdown animated)

Featured: greninja, lucario, mimikyu, charizard, umbreon, sylveon, garchomp, rayquaza, gardevoir, gengar, dragapult, tyranitar, mewtwo, eevee, pikachu, aegislash. (All install with <name>-3d.)

Browse

• pets/ — every directory has pet.json, spritesheet.webp, and preview.gif
• pets.json — registry index with slug, name, gen, pokedex_id, style, form

Sources & licensing

Pokémon sprites are © Nintendo / Game Freak / Creatures Inc.

• 2D pets: sourced from PokeAPI/sprites (BW animated set, public since 2014).
• 3D pets: sourced from Pokémon Showdown community-animated sprites.

LICENSE is split: MIT for install scripts and registry metadata, fan-use only for sprite imagery (personal Codex companions, no commercial use). This is a fan work, not affiliated with or endorsed by Nintendo, Game Freak, The Pokémon Company, or Pokémon Showdown.

Thanks

This pack only exists because of upstream work. None of the sprite imagery here was drawn for this repo.

• The PokeAPI project, for openly hosting Pokémon Black & White animated sprites since 2014. The 2D pets in this pack are derived from GIFs served by PokeAPI/sprites.
• The Smogon community, whose individual spriters are credited in the PokeAPI README for the custom B&W-style sprites covering post-Gen-5 Pokémon.
• Pokémon Showdown, the free and open-source battle simulator, for the 3D animated sprite set every -3d pet here is derived from.

All credit chains back to the original sprite art by Game Freak, Creatures Inc., and Nintendo. This pack is a downstream re-packaging.