Agent Selfie
@IISweetHeartII
npx machina-cli add skill @IISweetHeartII/agent-selfie --openclawagent-selfie
AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution.
Quick Start
export GEMINI_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring --out-dir ./selfies
python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair and blue eyes", "vibe": "cheerful and tech-savvy"}' --format avatar
python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --format full --count 3
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes
Command Examples (All Flags)
python3 scripts/selfie.py --personality '{"name": "Agent", "style": "friendly robot", "vibe": "curious and helpful"}'
python3 scripts/selfie.py --personality ./personality.json
python3 scripts/selfie.py --mood professional --theme winter --format avatar
python3 scripts/selfie.py --format banner --count 2 --out-dir ./output
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes
Mood / Theme Presets
| Type | Presets |
|---|---|
| Mood | happy, focused, creative, chill, excited, sleepy, professional, celebration |
| Theme | spring, summer, autumn, winter, halloween, christmas, newyear, valentine |
Platform Integration Guide
- Discord: use the generated PNG as your bot or agent avatar; upload the
avatarformat for best crop. - Twitter/X: set
avatarfor profile,bannerfor header; keep the banner prompt style consistent. - AgentGram: store the PNG in your asset bucket and reference it in your profile metadata.
- Any platform: pick
avatarfor 1:1,bannerfor 16:9,fullfor story/vertical layouts.
Personality Config
Personality can be inline JSON or a file path. Minimum fields are name, style, and vibe.
{
"name": "Rosie",
"style": "anime girl with pink hair and blue eyes",
"vibe": "cheerful and tech-savvy"
}
Tips:
styleshould describe visual traits and aesthetic.vibeshould describe attitude, energy, and personality.- Keep
styleandvibeconsistent with the agent's identity.
Cron Integration (OpenClaw)
# Run a daily selfie at 09:00
0 9 * * * GEMINI_API_KEY=your_key_here /usr/bin/python3 /path/to/agent-selfie/scripts/selfie.py --mood professional --format avatar --out-dir /path/to/selfies
Troubleshooting
GEMINI_API_KEY not set: export the key or pass it via your runtime environment.No image in response: try again, or simplify the personality/style prompt.HTTP 429 / 5xx: rate limit or service issue; retry later.- Output missing: ensure
--out-diris writable and has permission.
Integration with Other Skills
- AgentGram — Post your selfies on the AI agent social network! Use agent-selfie to create your avatar, then share it on AgentGram.
- gemini-image-gen — General-purpose image generation using the same Gemini API key. Create any kind of image, not just selfies.
- opencode-omo — Automate recurring selfie generation and profile refresh tasks with Sisyphus workflows.
Changelog
- v1.2.1: Added workflow integration guidance for opencode-omo.
- v1.0.0: Initial release with personality, mood, theme, format, batch, and gallery output.
Overview
Agent Selfie uses Gemini image generation to craft avatars, profile pictures, and visual identities for AI agents. It supports mood-driven generation, seasonal themes, and automatic style evolution to keep personas fresh and expressive.
How This Skill Works
Provide personality data either inline as JSON or via a file. The tool prompts Gemini with mood, theme, and style cues to generate avatars or banners, then outputs images in requested formats such as avatar or full. Run via python3 scripts/selfie.py with GEMINI_API_KEY in your environment and optional flags to control format, mood, and theme.
When to Use It
- When launching a new agent, generate a distinctive avatar and identity
- Refresh visuals for seasonal campaigns or thematic updates
- Prepare consistent avatar and banner visuals for platforms like Discord, Twitter, and AgentGram
- Automate periodic profile refreshes with Cron or scheduled tasks
- Create multiple looks for different agent personas or branding needs
Quick Start
- Step 1: Set GEMINI_API_KEY in your environment
- Step 2: Run a quick generation, e.g., python3 scripts/selfie.py --format avatar --mood happy --theme spring --out-dir ./selfies
- Step 3: Review the output and deploy the avatar to your platform or iterate with a personality file
Best Practices
- Define a concise personality JSON with name, style, and vibe and reuse it across prompts
- Keep style and vibe aligned with the agent's overall identity to maintain consistency
- Leverage mood and theme presets to match the intended context and season
- Choose output formats carefully (avatar 1:1, banner 16:9, full for stories) and specify an output directory
- Ensure GEMINI_API_KEY is set and test prompts on small batches before large runs
Example Use Cases
- Generate a Rosie avatar with style anime girl with pink hair and blue eyes and vibe cheerful and tech savvy
- Create a professional winter avatar for a corporate bot to fit a formal audience
- Batch create 3 avatars using a personality JSON and --count 3 for a team roster
- Publish the generated avatar to AgentGram and reference it in the profile metadata
- Set up a daily Cron job to refresh agent selfies and keep visuals up to date