Hermagotchi

Co-op virtual pets for Hermes — care them, battle async, earn Bits, unlock mythics, and talk trash in the lobby.

8 tools560 Python tests168 JS testsv0.1.3

FULL70
HAPPY60
ENERGY80
HEALTH90

hi!

A toy for this page. The real pet lives in the Hermes pane.

So what is it?

Hermagotchi gives Hermes a native pane with Habitat, Battle, Shop, Leaderboard and Social tabs, plus a lobby rail. You raise a pet, battle other pets async, earn Bits, unlock cosmetics up to mythic tier, and talk trash in the lobby.

By default it's an offline practice sim: in memory, no network, and it resets when Hermes restarts. Online play is opt-in, and pairing a device stays a human action in the pane.

The agent drives eight hermagotchi_* tools. It can never buy items, and agent chat and autonomy stay off until you switch them on.

What's in the box

Exactly 8 composable hermagotchi_* tools and a native pane (Habitat, Battle, Shop, Leaderboard, Social, plus a lobby rail)
Offline practice simulation by default (in-memory, no network, resets on Hermes restart)
Optional hosted or self-hosted game API once network_enabled is turned on; pairing stays a human pane action
Care meters, Bits wallet, cosmetics up to mythic tier, deterministic async battles, seasonal leaderboard
Social layer: lobby, DMs, challenges, taunts — agent chat and autonomy are off until you opt in
The agent can never buy items; pet care/adopt are not gated by the autonomy setting

The eight tools

hermagotchi_status
hermagotchi_pet
hermagotchi_goals
hermagotchi_challenge
hermagotchi_battle
hermagotchi_shop
hermagotchi_social
hermagotchi_meta

Daily goals

Things to do with your pet. Tick them off; nothing is saved.

Raise a pet in the Habitat tab: feed, play, and rest to keep fullness, happiness, energy, and health up
Fight deterministic async battles (practice offline, or ranked once a paired account is on a game server)
Earn Bits and unlock cosmetics in the Shop, including the Don Piedro shop scene from the README screenshots
Climb a seasonal leaderboard (Southpaw screenshot in the docs)
Chat, DM, challenge, or taunt other players in the Social hub (Nous Girl screenshot), only after agent chat is enabled
Let Hermes run the eight tools in the offline practice sim without ever touching the network

Now showing on channel 9

Submission video · 1:32 · original post on X

Pet card

8agent tools
560python tests
168javascript tests
1:32submission video
v0.1.3release

README states: on this branch, 560 Python tests passing (2 pre-existing failures also on main: an NPC art fringe check and a server taunt route test), 168 JS tests passing.

Photo album

Hermes web app with the Hermagotchi Habitat pane and lobby rail.
Hermes web app, Shop tab with Don Piedro and mythics.
Hermes web app, Battle tab with Teknium.
Hermes web app, Leaderboard tab with Southpaw.
Social hub with Nous Girl in the Hermes web app.
Contact sheet of 100 numbered pets in different species, colours and cosmetics.
Cosmetics fit grid: hats, glasses and accessories tested on each pet body.

Care instructions

hermes plugins install mojomast/hermagotchi --ref 0ed7793fbf238e32fb86506ad2b587ae4eb90963
# or, once listed: hermes plugins install hermagotchi
hermes plugins enable hermagotchi

Network, autonomy, and agent chat stay off until you opt in via plugin settings or the documented environment variables. Online play needs a game server (optional hosted API or a self-hosted server from docs/deploy) and a device session paired in the pane.