Agent Cast

Cast is a forkable 3D character viewer for AI agent packs.

Built by Voxyz AI.

It gives each agent a small stage:

roster -> 3D / portrait stage -> soul preview -> identity -> role card -> docs -> compare

The app is intentionally static by default. You can run it without a database, an account, or a model-generation API key.

Demo

Watch the demo video

Run

pnpm install
pnpm dev

Then open the local URL printed by Next.

Production preview:

pnpm build
pnpm exec next start -p 3001

Replace The Agents

Start with:

• data/sample-agents.ts
• data/load-agents.ts
• docs/DATA_MODEL.md

The app consumes a CastAgent[]. The default loadAgents() returns the local sample array, but you can replace it with JSON, CMS data, a database adapter, or markdown files.

Replace The 3D Models And Images

Start with:

• data/sample-assets.ts
• public/cast/models/
• public/cast/thumbs/
• docs/ASSET_LICENSES.md

Each agent can have:

• modelSrc for a GLB stage
• portraitSrc or thumbnailSrc for a 2D stage
• no asset at all, which falls back to a sketch avatar

Wire A Model Provider

The left-bottom Forge panel is ready for image upload, preview, progress, and success/failure states. It ships with a mock provider.

Read docs/MODEL_GENERATION.md before adding a real provider. Real provider keys belong in a server route you own. They are not included in this template.

License

Code and included sample assets are MIT licensed. See docs/ASSET_LICENSES.md for the asset list.