@shiki0111/pix-avatar
v0.1.0
Published
Spec-first 40x40 pixel avatar generator for agents, CLI, SDK, and HTTP workflows.
Readme
Pix Avatar
Spec-first 40x40 pixel avatar generator for agents, CLIs, SDKs, and HTTP workflows.
The canonical source is an Avatar Spec. PNG, SVG, debug grids, anchors, layer reports, and pixel inspection are all deterministic render outputs.
Quick Start
Production CLI install:
npm install -g @shiki0111/pix-avatar
pix-avatar random --seed 42 --out spec.json
pix-avatar render spec.json --out avatar.png
pix-avatar inspect spec.json --pixel 20,26 --jsonPackage-local install:
npm install @shiki0111/pix-avatar
npx pix-avatar random --seed 42 --out spec.jsonLocal development:
npm install
npm run devCLI examples:
npm run cli -- random --seed 42 --out examples/specs/seed-42.json
npm run cli -- render examples/specs/seed-42.json --out examples/outputs/seed-42.png --debug-grid examples/outputs/seed-42-grid.png --debug-anchors examples/outputs/seed-42-anchors.png
npm run cli -- inspect examples/specs/seed-42.json --pixel 20,26 --json
npm run validate:assetsThe default logical canvas is 40x40; the default scale is 12, so PNG
renders are 480x480 unless --scale is provided.
HTTP API:
npm run serve:apiEndpoints include GET /traits, POST /avatar/random, POST /avatar/render,
POST /avatar/patch, POST /avatar/inspect, and POST /avatar/validate.
