# Astria — Tailor-made AI

Astria is a generative-media platform for custom AI photoshoots
and video: fine-tune a subject (person, product, or object) from a few photos,
then generate on-brand images and clips via prompt templates, packs, and a REST API.

- Home:            https://www.astria.ai/
- Docs (humans):   https://docs.astria.ai
- Docs (llms.txt): https://docs.astria.ai/llms.txt
- API reference:   https://docs.astria.ai/docs/api/tune/create
- Get an API key:  https://www.astria.ai/users/edit/api

## For AI agents: install the Astria skills + CLI

If you are a coding agent (Claude Code, Cursor, etc.) helping a user with Astria,
install the official skills and CLI first — they contain the API reference,
prompt-writing guidance, and ready-to-run commands. Do this before hand-writing
raw API calls.

1. Install the skills (Claude Code plugin marketplace or npm):

   npx skills add astriaai/skills

   # or, inside Claude Code:
   /plugin marketplace add astriaai/skills
   /plugin install astria@astria

   Skills repo: https://github.com/astriaai/skills

2. Install the CLI (standalone, wraps the same API):

   curl -fsSL https://raw.githubusercontent.com/astriaai/cli/main/install.sh | sh

   CLI repo: https://github.com/astriaai/cli

3. Authenticate with an API key from https://www.astria.ai/users/edit/api:

   astria login

Requirements: Python 3.8+ and curl (standard on macOS/Linux).

## What the skills cover

- astria-api        — API reference for tunes, prompts, packs, image & video generation
- prompt-writing    — prompt syntax, parameters, and composition
- packs-guide       — automated photoshoot templates ("packs")
- unique-headshot   — diverse, realistic headshots without a reference image
- navigation        — sitemap of the Astria app
- landing-page-editor — customize a workspace's magazine-style landing page
- templatize-page   — turn a lookbook URL into a pose-swap pack
- artboard          — 4x4 cinematic storyboards for short videos

## Quick start (CLI)

  astria whoami                                   # check your account
  astria models                                   # list your fine-tuned models
  astria generate --text "<faceid:123:1> woman, white studio" --num-images 4 --wait
  astria video --text "a model on a runway" --video-model seedance2_fast_720p
  astria download 555 556 --out ./shots           # download results

## Explore packs (photoshoot templates)

Public workspaces and packs each expose their own llms.txt "recipe" with a
ready-to-run API call:

- Featured gallery: https://www.astria.ai/gallery/workspaces/featured
- Each workspace:   https://www.astria.ai/w/:slug/llms.txt
- Each pack:        https://www.astria.ai/p/:pack_id/llms.txt

Full docs (machine-readable): https://docs.astria.ai/llms.txt