Studio Lumiere CLI

Local SDK + CLI for AI-powered jewelry product photography. This package lives inside the main repo and pulls its options, templates, and prompt logic from the Studio Lumiere source of truth.

Setup

cd studio-cli
npm install

Create .env (or copy studio-cli/.env.example):

GEMINI_API_KEY=your_key_here
LUMIERE_OUTPUT_DIR=outputs

Development

npm run dev -- generate --images "ring.jpg" --template hand_model --quantity 2

Sync From Studio

Use this to copy the latest Studio Lumiere prompt and option files into studio-cli/src/studio before building or running locally:

npm run sync

Commands

The CLI exposes: generate, refine, upscale, muse, caption, video, stitch, tired-girl, annotate, before-after, grid, collate, list.

The caption command analyzes an image with Gemini and returns one overlay-ready top line and one bottom line for social media traction and engagement. It saves its result under outputs/captions/<timestamp>/caption.json.

The video command now supports:

• gemini with veo-3.1 and veo-3.1-fast
• kie.ai with kling-3.0
• optional --start-frame and --end-frame inputs
• saving the generated video locally under outputs/videos/<timestamp>/video.mp4
• silent local output videos with no audio track

The stitch command concatenates mixed image/video sequences into one output video using bundled FFmpeg.

Video outputs are normalized to be silent:

• Kling / KIE is requested with sound: false
• Veo outputs are saved locally without audio by stripping the audio track after download

Example:

lumiere caption --image "./output.png"

Typical follow-up workflow:

1. run lumiere caption to get topText and bottomText
2. run lumiere annotate once for the top text
3. run lumiere annotate again on the annotated output for the bottom text

For full flag documentation and examples, see: studio-cli/.agents/skills/studio-lumiere-cli/SKILL.md.

Project Layout

studio-cli/
  src/
    cli.ts
    index.ts
    clients/
    config/
    image/
    pipelines/
    prompt/
    storage/
    studio/
  scripts/
    sync-studio.mjs