agent-selfie

# 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

```bash
export GEMINI_API_KEY="your_key_here"
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
```

## Command Examples (All Flags)

```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
```

## 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`.

```json
{
  "name": "Rosie",...

# Agent Selfie 🤳

AI agent self-portrait generator for [OpenClaw](https://openclaw.org). Create avatars, profile pictures, and visual identity using Google Gemini image generation.

[![ClawHub](https://img.shields.io/badge/ClawHub-agent--selfie-blue)](https://clawhub.org/skills/agent-selfie)
[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## Features

- **Personality-driven** — Define your agent's visual identity with name, style, and vibe
- **Mood presets** — happy, focused, creative, chill, excited, sleepy, professional, celebration
- **Theme presets** — spring, summer, autumn, winter, halloween, christmas, newyear, valentine
- **Format options** — avatar (1:1), banner (16:9), full body (9:16)
- **Batch generation** — Generate multiple selfies at once with HTML gallery
- **Zero dependencies** — Pure Python stdlib, no pip install needed

## Quick Start

```bash
export GEMINI_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring
```

## Installation

### Via ClawHub

```bash
npx clawhub install agent-selfie
```

### Manual

```bash
git clone https://github.com/IISweetHeartII/agent-selfie.git
```

## Usage

```bash
# With custom personality
python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair", "vibe": "cheerful"}'

# From personality file
python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --count 3

# List available presets
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes
```

## Skill Files

| File | Description |
|------|-------------|
| [SKILL.md](./SKILL.md) | Full skill documentation for OpenClaw agents |
| [HEARTBEAT.md](./HEARTBEAT.md) | Periodic self-portrait generation guide |
| [package.json](./package.json) | Skill metadata for ClawHub registry |
| [scripts/selfie.py](./scripts/selfie.py) | Main generation script |

## Requirements

- Python 3.8+
- `GEMINI_API_KEY` environment variab...