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 ./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
avatar format for best crop.
- Twitter/X: set
avatar for profile, banner for 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
avatar for 1:1, banner for 16:9, full for 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:
style should describe visual traits and aesthetic.
vibe should describe attitude, energy, and personality.
- Keep
style and vibe consistent 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-dir is 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.
1---2name: agent-selfie3description: 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.4---5
6# agent-selfie
7
8AI 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.
9
10## Quick Start
11
12```bash
13export GEMINI_API_KEY="your_key_here"
14python3 scripts/selfie.py --format avatar --mood happy --theme spring --out-dir ./selfies
15```
16
17```bash
18python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair and blue eyes", "vibe": "cheerful and tech-savvy"}' --format avatar
19```
20
21```bash
22python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --format full --count 3
23```
24
25```bash
26python3 scripts/selfie.py --moods
27python3 scripts/selfie.py --themes
28```
29
30## Command Examples (All Flags)
31
32```bash
33python3 scripts/selfie.py --personality '{"name": "Agent", "style": "friendly robot", "vibe": "curious and helpful"}'
34python3 scripts/selfie.py --personality ./personality.json
35python3 scripts/selfie.py --mood professional --theme winter --format avatar
36python3 scripts/selfie.py --format banner --count 2 --out-dir ./output
37python3 scripts/selfie.py --moods
38python3 scripts/selfie.py --themes
39```
40
41## Mood / Theme Presets
42
43| Type | Presets |
44| --- | --- |
45| Mood | happy, focused, creative, chill, excited, sleepy, professional, celebration |
46| Theme | spring, summer, autumn, winter, halloween, christmas, newyear, valentine |
47
48## Platform Integration Guide
49
50- Discord: use the generated PNG as your bot or agent avatar; upload the `avatar` format for best crop.
51- Twitter/X: set `avatar` for profile, `banner` for header; keep the banner prompt style consistent.
52- AgentGram: store the PNG in your asset bucket and reference it in your profile metadata.
53- Any platform: pick `avatar` for 1:1, `banner` for 16:9, `full` for story/vertical layouts.
54
55## Personality Config
56
57Personality can be inline JSON or a file path. Minimum fields are `name`, `style`, and `vibe`.
58
59```json
60{
61 "name": "Rosie",
62 "style": "anime girl with pink hair and blue eyes",
63 "vibe": "cheerful and tech-savvy"
64}
65```
66
67Tips:
68- `style` should describe visual traits and aesthetic.
69- `vibe` should describe attitude, energy, and personality.
70- Keep `style` and `vibe` consistent with the agent's identity.
71
72## Cron Integration (OpenClaw)
73
74```cron
75# Run a daily selfie at 09:00
760 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
77```
78
79## Troubleshooting
80
81- `GEMINI_API_KEY not set`: export the key or pass it via your runtime environment.
82- `No image in response`: try again, or simplify the personality/style prompt.
83- `HTTP 429 / 5xx`: rate limit or service issue; retry later.
84- Output missing: ensure `--out-dir` is writable and has permission.
85
86## Integration with Other Skills
87
88- **[AgentGram](https://clawhub.org/skills/agentgram)** — Post your selfies on the AI agent social network! Use agent-selfie to create your avatar, then share it on AgentGram.
89- **[gemini-image-gen](https://clawhub.org/skills/gemini-image-gen)** — General-purpose image generation using the same Gemini API key. Create any kind of image, not just selfies.
90- **[opencode-omo](https://clawhub.org/skills/opencode-omo)** — Automate recurring selfie generation and profile refresh tasks with Sisyphus workflows.
91
92## Changelog
93
94- v1.2.1: Added workflow integration guidance for opencode-omo.
95- v1.0.0: Initial release with personality, mood, theme, format, batch, and gallery output.