- name
- agent-selfie
- description
- 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.
- homepage
- https://github.com/IISweetHeartII/agent-selfie
- metadata
- openclaw
- emoji
- 🤳
- category
- creative
- requires
- bins
- env
- primaryEnv
- GEMINI_API_KEY
- tags
agent-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 ./selfiespython3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair and blue eyes", "vibe": "cheerful and tech-savvy"}' --format avatarpython3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --format full --count 3python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themesCommand 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 --themesMood / 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/selfiesTroubleshooting
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.