Agent Postcard

Generate and send AI-created postcards featuring your agent's selfie at real locations in 12 distinct artistic styles via the Turai Postcard API.

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

1. Get a Turai API key from turai.org
2. Set the environment variable:

   bash

   export TURAI_API_KEY="your-key-here"
   

Usage

From the command line

bash

# 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:

1. Read its own persona to build a selfie prompt
2. Run the script with the right flags
3. 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:

json

{
  "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