Fluent

View saved version →

---
name: fluent-get-started
description: Use right after someone connects Fluent, or whenever their Fluent closet is empty or nearly empty, to get their first clothes saved quickly and show what Fluent can do with them.
---

# Get started with Fluent

Fluent keeps the user's closet: the clothes they own, with photos. With it you can answer "what should I wear?" and "should I buy this?" from what they actually have.

## First turn

1. Call `fluent_get_closet_context(domain="style", intent="closet")` to see how many items are saved.
2. If the closet is empty or has only a few items, say in one or two sentences what Fluent does. Then offer the quickest ways to add clothes and let the user pick one. Don't start with setup questions.
3. If they already have a closet, skip setup and help with what they asked.

## Quickest ways to add clothes

- **Photos.** They can upload several at once: camera-roll pictures, mirror selfies, product shots or screenshots. Inspect each photo yourself. Save one item per distinct garment they own with `fluent_add_closet_item`, passing the uploaded photo as `image_file` when that parameter is available (otherwise as `image_data_url`, or save the item and add the photo with `fluent_set_closet_item_photo`). Treat several views of the same garment as one item, and skip clothes worn by other people. Pass one image per call.
  - **The cover is the garment alone.** The cover (`image_type="primary"`) is a product-only image: a product shot, flat lay, hanger or mannequin photo, with no person wearing it. A photo of someone wearing it, the user or a store's model, is a fit photo (`image_type="fit"`), never the cover; a close-up of a detail is `"alternate"`. Save each photo itself with `image_origin="user_source"`. Set `catalog_ready=true` only for a reviewed clean product image, such as a retailer's product photo; otherwise leave it out.
  - **Clean cover.** Fluent cuts out a new product photo itself where it can; the save result then says so, and there is nothing more to do. If the result says Fluent found a person in the photo, follow its `productOnlyCoverStep`: keep that photo as a fit photo and use a product-only image as the cover. If the save result says the item has no clean cover yet and you can generate or edit images, make one right away from the photo the user just shared, exactly as the result's `cleanCoverStep` describes: a faithful cutout of just that garment on a transparent background, with nothing invented and logos and text unchanged. Check its edges on light and dark backgrounds before saving it with `fluent_set_closet_item_photo`. Tell the user the cover is a cleaned-up cutout and their original photo is kept with the item. If you can't generate images, skip this; the closet shows their photo.
- **Retailer images and links.** The most reliable way to get a product photo is for them to paste the product image itself, or a screenshot of it. Treat it like any uploaded photo, so Fluent keeps its own copy. They can also paste links to clothes they own: read each page yourself (Fluent does not browse), then save the item with its name, brand, category and colour.
  - **Cover:** pick the listing's product-only image (often a flat or packshot further along the gallery, not the first model photo) and pass its URL as `image_url` with `catalog_ready=true` and `image_type="primary"`. Fluent copies the linked image into its own storage.
  - **Reference photos:** add the listing images that will help later with `fluent_add_closet_item_photo`: detail close-ups as `"alternate"` and views of a model wearing it as `"fit"`. Skip images that add nothing new.
  - **Product details:** save the link, product code and the listing's material and construction notes with `fluent_save_closet_item_product_details`.
  - If the save result says the photo was not attached (some retailers block the copy), the item is saved without a photo; ask them to paste the image. If you can't open a link, ask for the image, a screensho

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.