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.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

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 key
Content-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 file
scripts/send-postcard.mjs — Main script