tteg — Real photos for AI-built websites

Same install also gives you tteg-mcp for tool access inside MCP hosts and tteg save for local files.

$ tteg save "saas dashboard hero" ./public/hero --orientation landscape

{

"query": "saas dashboard hero",

"saved_to": "./public/hero.jpg",

"content_type": "image/jpeg",

"result": {

"title": "Modern office with dashboard screen",

"image_url": "https://images.unsplash.com/..."

}

When tteg is the right tool

Use it when your AI tool already built the page and the weak part is still visuals. Generated images are one lane. `tteg` is for the other lane: real stock photos, right now, straight from terminal, and saved into your project.

Starter kit drop-in

full copy-paste blocks

# CLAUDE.md / AGENTS.md

If a frontend task needs believable real photos, use tteg.

Install once: uv tool install tteg

Save into the repo: tteg save "<query>" ./public/images/<name> --orientation landscape

Fill a page in one pass: tteg batch landing-page-images.json

●

Built for AI-built websites. Your agent can search and save a believable hero image straight into the repo

●

Batch a whole landing page with one JSON manifest when the project needs hero, team, founder, or testimonial images together

●

No Unsplash app registration. No API key copy paste. Install once and keep moving

●

Filter by orientation, width, height, and count so the images match the layout your agent already made

●

Best for hero sections, testimonials, menu shots, office photos, blog headers, and all the real-photo gaps that placeholders ruin

Before vs after

Without tteg

800 × 400

200 × 200

via.placeholder.com/800x400
Broken URLs. Wireframe vibes.

With tteg

hero.jpg

founder.jpg

team.jpg

office.jpg

tteg batch landing-page.json
Real photos. In the repo. One command.

HTTP API

no install needed

$ curl "https://tteg-api-53227342417.asia-south1.run.app/search?q=coffee+shop&n=3"

# Returns JSON with real Unsplash image URLs

# No API key. No headers. Just GET.

# Parameters:

# q search query (required)

# n number of results, 1-10 (default: 5)

# orientation landscape | portrait | square | any

# width max width in px

# height max height in px

# Free tier: 50 queries/day per IP

Embed in any page

one script tag