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
CODEBLOCK0
CODEBLOCK1
CODEBLOCK2
CODEBLOCK3
Command Examples (All Flags)
CODEBLOCK4
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.
CODEBLOCK5
Tips:
- -
style should describe visual traits and aesthetic. - INLINECODE10 should describe attitude, energy, and personality.
- Keep
style and vibe consistent with the agent's identity.
Cron Integration (OpenClaw)
CODEBLOCK6
Troubleshooting
- -
GEMINI_API_KEY not set: export the key or pass it via your runtime environment. - INLINECODE14 : try again, or simplify the personality/style prompt.
- INLINECODE15 : 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.
agent-selfie
AI智能体自拍生成器。使用Gemini图像生成功能创建头像、个人资料图片和视觉标识。支持基于情绪生成、季节性主题和自动风格演化。
快速开始
bash
export GEMINIAPIKEY=yourkeyhere
python3 scripts/selfie.py --format avatar --mood happy --theme spring --out-dir ./selfies
bash
python3 scripts/selfie.py --personality {name: Rosie, style: anime girl with pink hair and blue eyes, vibe: cheerful and tech-savvy} --format avatar
bash
python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --format full --count 3
bash
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes
命令示例（所有参数）
bash
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
情绪/主题预设
| 类型 | 预设 |
|---|
| 情绪 | 快乐、专注、创意、放松、兴奋、困倦、专业、庆祝 |
| 主题 |
春季、夏季、秋季、冬季、万圣节、圣诞节、新年、情人节 |
平台集成指南
- - Discord：使用生成的PNG作为你的机器人或智能体头像；上传avatar格式可获得最佳裁剪效果。
- Twitter/X：设置avatar作为个人头像，banner作为横幅；保持横幅提示风格一致。
- AgentGram：将PNG存储在你的资产桶中，并在个人资料元数据中引用。
- 任何平台：选择avatar用于1:1比例，banner用于16:9比例，full用于故事/竖版布局。
个性配置
个性可以是内联JSON或文件路径。最少字段为name、style和vibe。
json
{
name: Rosie,
style: anime girl with pink hair and blue eyes,
vibe: cheerful and tech-savvy
}
提示：
- - style应描述视觉特征和美学风格。
- vibe应描述态度、能量和个性。
- 保持style和vibe与智能体的身份一致。
Cron集成（OpenClaw）
cron
每天09:00运行一次自拍
0 9
* GEMINI
APIKEY=your
keyhere /usr/bin/python3 /path/to/agent-selfie/scripts/selfie.py --mood professional --format avatar --out-dir /path/to/selfies
故障排除
- - GEMINIAPIKEY not set：导出密钥或通过运行时环境传递。
- No image in response：重试，或简化个性/风格提示。
- HTTP 429 / 5xx：速率限制或服务问题；稍后重试。
- 输出缺失：确保--out-dir可写且有权限。
与其他技能的集成
更新日志
- - v1.2.1：添加了opencode-omo的工作流集成指南。
- v1.0.0：初始版本，支持个性、情绪、主题、格式、批量和图库输出。
