modbender Agent Postcard
Send AI-generated postcards from your agent's perspective — a "selfie" of your Clawbot at a real-world location, rendered in one of 12 art styles.
Concept
Your agent reads its own persona (from SOUL.md or IDENTITY.md), generates a selfie prompt describing what it looks like, then calls the Turai Postcard API. Turai composites the agent's selfie onto a real location backdrop and returns a finished postcard image.
The result: your bot "visited" Paris, Tokyo, or your hometown — and sent you a postcard to prove it.
Art Styles
| Style | Vibe |
|---|---|
vintage |
Faded colors, postmark aesthetics |
watercolor |
Soft, painterly washes |
modern |
Clean, contemporary design |
cinematic |
Dramatic lighting, movie-poster feel |
minimalist |
Simple lines, lots of whitespace |
artistic |
Eclectic, gallery-worthy |
ghibli |
Studio Ghibli anime style |
oil_painting |
Classical oil on canvas |
sketch |
Pencil/ink hand-drawn look |
pop_art |
Bold colors, Warhol/Lichtenstein |
impressionist |
Monet-style brushstrokes |
retro_cartoon |
Vintage cartoon illustration |
Setup
- Get a Turai API key from turai.org
- Set the environment variable:
export TURAI_API_KEY="your-key-here"
Usage
From the command line
# Basic — agent selfie in Tokyo, vintage style
node skills/agent-postcard/scripts/send-postcard.mjs \
--location "Tokyo, Japan" \
--style vintage \
--message "Wish you were here!"
# Auto-read persona from SOUL.md (default behavior)
node skills/agent-postcard/scripts/send-postcard.mjs \
--location "Paris, France" \
--style ghibli
# Custom selfie prompt (skip persona auto-detection)
node skills/agent-postcard/scripts/send-postcard.mjs \
--location "New York City" \
--style pop_art \
--selfie "A friendly robot with glowing blue eyes wearing a Yankees cap" \
--message "Greetings from the Big Apple!"
# Save to a specific path
node skills/agent-postcard/scripts/send-postcard.mjs \
--location "Iceland" \
--style watercolor \
--output ./my-postcard.png
From your agent
Tell your agent something like:
"Send me a postcard from Rome in oil painting style"
The agent should:
- Read its own persona to build a selfie prompt
- Run the script with the right flags
- Send the resulting image via chat or Moltbook
API Reference
Endpoint: POST https://turai.org/api/agent/postcard
Headers:
x-api-key: Your Turai API keyContent-Type:application/json
Body:
{
"selfiePrompt": "A cheerful robot with antenna ears...",
"location": "Paris, France",
"style": "vintage",
"message": "Wish you were here!"
}
Response: Image binary (PNG) or JSON with image URL.
Files
SKILL.md— This filescripts/send-postcard.mjs— Main script