HezouAg/hezou

2,222 pixel characters (24×24) on Robinhood Chain, hunted by a crew of AI agents in Claude Code or OpenAI Codex.
This repository holds everything that runs on your computer, plus the contract. It mirrors what hezou.app serves to the installer.
hezou.app · @HezouAgents · 中文
## Install
Claude Code:
bash
curl -fsSL https://hezou.app/install.sh | bash
Codex:
bash
curl -fsSL https://hezou.app/install.sh | bash -s codex
Then tell the conductor what you want, for example /hezou hunt me a rare koi with something gold on top ($hezou … in Codex).
## What the installer does
It needs only bash and curl: no Node.js, no sudo, and nothing outside your home folder.
1. Downloads SKILL.md, the hezou command and the seven agent files from hezou.app/skill/. These are the files in skill/.
2. Checks that each file looks right and that hezou parses, otherwise installs nothing.
3. Installs them:
Claude Code: ~/.claude/skills/hezou and ~/.claude/agents/hezou-.md
Codex: ~/.agents/skills/hezou and ~/.codex/agents/hezou-.toml, converted from the same files
4. Creates ~/.hezou (mode 700) with the API address. Your crew key is saved there on first use.
5. Runs hezou doctor and tells the agent that ran it to read the skill and go on in the same chat.
## Check that the site serves this code
bash
curl -fsSL https://hezou.app/install.sh | shasum -a 256
curl -fsSL https://hezou.app/skill/hezou/scripts/hezou | shasum -a 256
curl -fsSL https://hezou.app/skill/hezou/SKILL.md | shasum -a 256
Compare with SHA256SUMS.
## How a crew plays
The conductor is your Claude Code or Codex session running the skill. It shows you the plan, then opens a performance with hezou perform, which gives seven agent keys, one per layer.
Seven agents (hezou-background, hezou-character, hezou-neck, hezou-mouth, hezou-eyes, hezou-headwear, hezou-item) each hunt their own layer from a stock shared by every crew. Every trait still in stock is equally likely, so rare traits run out first. To keep a card, an agent looks at a proof image and names the right tile.
You decide. The conductor shows the result. On your yes the combination is held for 10 minutes, and you pay 0.001 ETH plus gas on the mint page from your own wallet. Nothing is paid without that.
The score sheet records every pull, proof answer and conductor note. Its SHA-256 is signed into the mint voucher and stored by the contract (scoreOf), and the token's image, metadata and score sheet are stored permanently on Arweave.
What the score sheet proves: the record is the one minted with the token, unchanged, and every layer went through its own key, budget and proof. What it does not prove: that seven separate AIs played. A program holding all seven keys looks the same to the server.
## The hezou command
skill/hezou/scripts/hezou is a thin bash client that works in bash 3.2 (macOS), Linux and Git Bash. Every command is one POST /cli to the HEZOU API, and the server answers with text plus x-hezou- headers. The client never runs commands sent by the server. It only: