# Motif documentation

> Install Motif, add a fal key, and make, edit and inspect images from your terminal.

Reach for Motif when a project needs images or short video made or edited from the command line, with a price shown before anything is spent. Install it with `npm install -g @howells/motif-cli`; the SDK is `@howells/motif-sdk`.

## Docs

- [Looks and Moods](https://motif.danielhowells.com/docs/looks-and-moods): A Look is the kind of image. A Mood adds the light.
- [For agents](https://motif.danielhowells.com/docs/agents): JSON output, a price before every run, and a schema for every command.
- [SDK](https://motif.danielhowells.com/docs/sdk): @howells/motif-sdk runs the same Tasks as the CLI from Node, with a Model chosen for you and a price you can read first.

## Getting started

- [Quickstart](https://motif.danielhowells.com/docs/quickstart): Install Motif, add a fal key and make your first image.
- [Setup and keys](https://motif.danielhowells.com/docs/setup): Install the CLI, add a fal key, and know whose money a run spends.

## Commands

- [Commands](https://motif.danielhowells.com/docs/commands): Every command, grouped by what it does, and the options they share.

### Make

- [A picture from a sentence](https://motif.danielhowells.com/docs/commands/generate): Make an image from a prompt.
- [Variations](https://motif.danielhowells.com/docs/commands/vary): Variations of an image.
- [A matching set](https://motif.danielhowells.com/docs/commands/series): A consistent set from a theme.

### Edit

- [Remove an object](https://motif.danielhowells.com/docs/commands/erase): Remove something and fill the gap.
- [Remove the background](https://motif.danielhowells.com/docs/commands/cutout): Remove the background.
- [Extend the frame](https://motif.danielhowells.com/docs/commands/reframe): Extend to a new aspect ratio.
- [Upscale up to four times](https://motif.danielhowells.com/docs/commands/upscale): Make it larger.
- [Repair a damaged photo](https://motif.danielhowells.com/docs/commands/restore): Fix noise, blur, damage and colour.
- [Relight a photo](https://motif.danielhowells.com/docs/commands/relight): Relight to a described light or a Mood.
- [Match the style of another picture](https://motif.danielhowells.com/docs/commands/restyle): Redraw in a reference's style.
- [Put a garment on a person](https://motif.danielhowells.com/docs/commands/try-on): Dress a person in a garment.

### Analyse

- [Ask about a picture](https://motif.danielhowells.com/docs/commands/ask): Caption, count, find or ask.
- [Select one object](https://motif.danielhowells.com/docs/commands/segment): Mask or cut out a named thing.
- [Depth, pose and edge maps](https://motif.danielhowells.com/docs/commands/map): Depth, edge, normal or pose map.

### Materials and files

- [Materials for 3D](https://motif.danielhowells.com/docs/commands/material): PBR maps from a surface photo.
- [Seamless textures](https://motif.danielhowells.com/docs/commands/tile): A seamlessly tiling texture.
- [Split a picture into layers](https://motif.danielhowells.com/docs/commands/layers): Split into transparent layers.
- [Convert to SVG](https://motif.danielhowells.com/docs/commands/vectorize): Trace to a clean SVG.
- [A 3D model from a photo](https://motif.danielhowells.com/docs/commands/mesh): A textured 3D mesh, rigged if asked.
- [Film from a still](https://motif.danielhowells.com/docs/commands/animate): Turn an image into a video.
- [Make a contact sheet](https://motif.danielhowells.com/docs/commands/sheet): A captioned contact sheet.

### Terminal

- [Work in the terminal Studio](https://motif.danielhowells.com/docs/commands/studio): The interactive terminal Studio.
- [Read the CLI's schema](https://motif.danielhowells.com/docs/commands/describe): Print the CLI schema as JSON.
- [See the latest Generation](https://motif.danielhowells.com/docs/commands/last): Show the latest Generation.
- [See past Generations and spend](https://motif.danielhowells.com/docs/commands/history): Past Generations and spend.

## Agent skills

- [motif-documentation](https://motif.danielhowells.com/docs/.well-known/agent-skills/motif-documentation/SKILL.md): Read the Motif documentation instead of answering from memory. Install Motif, add a fal key, and make, edit and inspect images from your terminal. Use when a task involves Motif documentation: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://motif.danielhowells.com/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://motif.danielhowells.com/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://motif.danielhowells.com/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://motif.danielhowells.com/docs/openapi.json.
- [Agent skills](https://motif.danielhowells.com/docs/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://motif.danielhowells.com/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://motif.danielhowells.com/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://motif.danielhowells.com/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://motif.danielhowells.com/docs/sitemap.xml): Every indexable page URL with its last-modified date.