Generating Avatars

Use the stylebook CLI to generate new avatars.

Prerequisites

• Python 3.11+
• Poetry installed
• API keys configured (OPENAI_API_KEY or GEMINI_API_KEY)

Commands

Generate Human Avatars

Create stylized avatars from team photos.

stylebook generate avatars humans

Options:

• --subject NAME - Generate for specific person only
• --model MODEL - AI model to use (default: gemini-3-pro-image-preview)

Generate Agent Avatars

Create avatars for AI agents from definitions.

stylebook generate avatars agents

Options:

• --agent NAME - Generate for specific agent only
• --tags TAGS - Filter by tags (comma-separated)

Output Structure

Generated avatars are saved to:

output/avatars/
├── humans/
│   └── {subject}/
│       ├── {subject}.1.png
│       └── {subject}.2.png
└── agents/
    └── {agent}/
        ├── {agent}.1.png
        └── {agent}.2.png