studio-lumiere-cli 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "studio-lumiere-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Local SDK + CLI for Studio Lumiere image and video generation",
   "type": "module",
   "bin": {

package/skills/studio-lumiere-cli/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: studio-lumiere-cli
+description: Command-line usage for Studio Lumiere. Use when running npx studio-lumiere-cli to generate, refine, upscale, create a Muse, generate video, tired-girl, annotate, grid, or list IDs.
+---
+
+# Studio Lumiere CLI
+
+## Requirements
+- `GEMINI_API_KEY` must be set in your environment.
+- `LUMIERE_OUTPUT_DIR` is optional (defaults to `outputs`).
+
+## Invocation
+`npx studio-lumiere-cli <command> [options]`
+
+## list
+Print JSON for valid IDs.
+
+Example:
+```bash
+npx studio-lumiere-cli list templates
+```
+
+Allowed types:
+- `templates`
+- `ethnicities`
+- `skin-tones`
+- `hair-colors`
+- `backgrounds`
+- `background-types`
+- `vibes`
+- `resolutions`
+- `occasions`
+
+## generate
+Generate images from input jewelry photos.
+
+Example:
+```bash
+npx studio-lumiere-cli generate \
+  --images ./inputs/ring.jpg \
+  --template hand_model \
+  --detail nail_nude \
+  --ethnicity mena \
+  --skin-tone medium \
+  --hair-color brunette \
+  --background cream_silk \
+  --background-type studio \
+  --vibe clean \
+  --resolution portrait \
+  --quantity 1
+```
+
+Options:
+- `--images <paths>` (required): Comma-separated input image paths.
+- `--template <id>` (required): Template ID.
+- `--detail <id>`
+- `--secondary-detail <id>`
+- `--tertiary-detail <id>`
+- `--ethnicity <id>`
+- `--skin-tone <id>`
+- `--hair-color <id>`
+- `--background <id>`
+- `--background-type <id>`
+- `--vibe <id>`
+- `--resolution <id>`
+- `--occasion <id>`
+- `--quantity <n>`: Number of outputs (default `1`).
+- `--muse-id <id>`: Use a stored Muse.
+- `--muse-images <paths>`: Comma-separated Muse image paths.
+- `--no-enhance`: Disable prompt enhancement.
+
+Outputs:
+Generated files are written to `outputs/generations/<timestamp>/` (or `LUMIERE_OUTPUT_DIR/generations/<timestamp>/`) with `image_#.png` and `generation.json`.
+
+## refine
+Refine an existing image.
+
+Example:
+```bash
+npx studio-lumiere-cli refine \
+  --image ./outputs/image.png \
+  --instruction "Reduce glare and smooth background"
+```
+
+Options:
+- `--image <path>` (required)
+- `--instruction <text>` (required)
+- `--size <percent>`: Resize jewelry to a percentage of current size.
+
+Outputs:
+`outputs/refinements/<timestamp>/refined.png` and `refine.json`.
+
+## upscale
+Upscale an existing image.
+
+Example:
+```bash
+npx studio-lumiere-cli upscale --image ./outputs/image.png --scale 2
+```
+
+Options:
+- `--image <path>` (required)
+- `--scale <number>`: Scale factor (default `2`).
+
+Outputs:
+`outputs/upscales/<timestamp>/upscaled.png` and `upscale.json`.
+
+## muse
+Create a Muse from a source portrait.
+
+Example:
+```bash
+npx studio-lumiere-cli muse --name "Nadine" --source ./inputs/portrait.jpg --variations 3
+```
+
+Options:
+- `--name <name>` (required)
+- `--source <path>` (required)
+- `--variations <n>`: Number of variations (default `3`).
+
+Outputs:
+`outputs/muses/<timestamp>/variation_#.png`, `muse.json`, and an updated `muses.json` under the output root.
+
+## video
+Generate a video from a prompt.
+
+Example:
+```bash
+npx studio-lumiere-cli video --prompt "Slow pan over a diamond ring" --aspect 16:9 --duration 5
+```
+
+Options:
+- `--prompt <text>` (required)
+- `--aspect <ratio>`
+- `--duration <seconds>`
+
+Outputs:
+`outputs/videos/<timestamp>/video.mp4` (when available) and `video.json` with the operation name.
+
+## tired-girl
+Generate a tired-girl before image.
+
+Example:
+```bash
+npx studio-lumiere-cli tired-girl --muse-id muse_1700000000000 --quantity 2
+```
+
+Options:
+- `--muse-id <id>`: Muse ID (preferred).
+- `--image <path>`: Single reference image (used if no muse-id).
+- `--styles <ids>`: Comma-separated style IDs.
+- `--quantity <n>`: Number of variants (default `1`).
+
+Outputs:
+`outputs/tired_girl/<timestamp>/tired_girl_#.png` and `tired_girl.json`.
+
+## annotate
+Overlay text on an image.
+
+Example:
+```bash
+npx studio-lumiere-cli annotate --input ./in.png --output ./out.png --text "Hello" --banner
+```
+
+Options:
+- `--input <path>` (required)
+- `--output <path>` (required)
+- `--text <text>` (required)
+- `--font <name>`
+- `--size <px>`
+- `--weight <n>`
+- `--color <hex>`
+- `--stroke-color <value>`
+- `--stroke-width <px>`
+- `--banner`
+- `--banner-color <value>`
+- `--banner-padding <px>`
+- `--banner-radius <px>`
+- `--position <pos>`: `top-center|top-left|top-right|bottom-center|bottom-center-high|bottom-left|bottom-right|center`
+- `--padding <px>`
+- `--max-width <ratio>`
+
+Outputs:
+Writes the image to the provided `--output` path.
+
+## grid
+Assemble multiple images into a grid.
+
+Example:
+```bash
+npx studio-lumiere-cli grid \
+  --inputs ./a.png,./b.png,./c.png,./d.png \
+  --output ./grid.png \
+  --columns 2 \
+  --rows 2
+```
+
+Options:
+- `--inputs <paths>` (required): Comma-separated image paths.
+- `--output <path>` (required)
+- `--columns <n>` (default `2`)
+- `--rows <n>` (default `2`)
+- `--padding <px>` (default `20`)
+- `--background <hex>` (default `#000000`)
+- `--tile-width <px>`
+- `--tile-height <px>`
+
+Outputs:
+Writes the image to the provided `--output` path.

package/skills/studio-lumiere-cli/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Studio Lumiere CLI"
+  short_description: "CLI usage for Studio Lumiere image workflows"
+  default_prompt: "Use $studio-lumiere-cli to run Studio Lumiere CLI commands."

package/.agents/skills/annotate-image/SKILL.md

@@ -1,99 +0,0 @@
----
-name: annotate-image
-description: Write text or banners over images with the annotate helper via SDK/CLI; use when you need captioned or labeled outputs.
----
-
-# Skill: Image Annotation (local-lumiere)
-
-This skill describes how to write text over an image using the `annotate` helper in local-lumiere. It covers the SDK function, CLI usage, parameters, and defaults.
-
----
-
-## Quick Start
-
-```
-node dist/cli.js annotate \
-  --input path/to/image.png \
-  --output path/to/output.png \
-  --text "Your text here" \
-  --banner
-```
-
----
-
-## SDK API
-
-```ts
-import { annotateImage } from "./dist/index.js";
-
-await annotateImage(
-  "path/to/input.png",
-  "path/to/output.png",
-  "Your text here",
-  {
-    fontFamily: "Montserrat",
-    fontSize: 48,
-    fontWeight: 700,
-    color: "#FFFFFF",
-    strokeColor: "rgba(0,0,0,0.6)",
-    strokeWidth: 4,
-    banner: true,
-    bannerColor: "rgba(0,0,0,0.45)",
-    bannerPadding: 24,
-    bannerRadius: 16,
-    position: "top-center",
-    padding: 32,
-    maxWidthRatio: 0.85
-  }
-);
-```
-
-### Options
-
-- `fontFamily`: font family name (default `Montserrat`)
-- `fontSize`: size in px (default ~5% of min image dimension)
-- `fontWeight`: font weight (default `700`)
-- `color`: text color (default `#FFFFFF`)
-- `strokeColor`: outline color (default `rgba(0,0,0,0.6)`)
-- `strokeWidth`: outline width (default `fontSize * 0.08`, min 2)
-- `banner`: enable semi-transparent banner (default `false`)
-- `bannerColor`: banner color (default `rgba(0,0,0,0.45)`)
-- `bannerPadding`: inner padding (default `fontSize * 0.6`)
-- `bannerRadius`: corner radius (default `fontSize * 0.4`)
-- `position`: `top-center|top-left|top-right|bottom-center|bottom-center-high|bottom-left|bottom-right|center` (default `top-center`)
-- `padding`: distance from edges (default `fontSize * 0.8`)
-- `maxWidthRatio`: max text width as ratio of image width (default `0.85`)
-
----
-
-## CLI Usage
-
-```
-node dist/cli.js annotate \
-  --input path/to/image.png \
-  --output path/to/output.png \
-  --text "Your text here" \
-  --position top-center \
-  --size 48 \
-  --color #FFFFFF \
-  --banner
-```
-
----
-
-## Notes
-
-- The helper uses sharp + SVG overlay.
-- If the font is not installed locally, the system falls back to a generic sans-serif.
-
-End of skill.
-
-## Related Skills
-
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-images.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-video.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\refine-images.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\muse-management.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\tired-girl.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\image-grid.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\config-troubleshooting.md`

package/.agents/skills/config-troubleshooting/SKILL.md

@@ -1,97 +0,0 @@
----
-name: config-troubleshooting
-description: Reference for local-lumiere configuration defaults, environment variables, outputs, and troubleshooting; use when setup or runtime issues occur.
----
-
-# Reference: Configuration & Troubleshooting (local-lumiere)
-
-This file collects shared configuration guidance and common troubleshooting patterns for all local-lumiere skills.
-
----
-
-## 1) Configuration Reference
-
-### 1.1 Environment Variables
-
-- `GEMINI_API_KEY` (required)
-- `LUMIERE_OUTPUT_DIR` (optional, default `outputs`)
-
-### 1.2 Runtime Config Defaults
-
-```ts
-models.prompt = "gemini-3-flash-preview"
-models.image  = "gemini-3-pro-image-preview"
-models.video  = "veo-3.1-generate-preview"
-retry.maxRetries = 3
-retry.baseDelayMs = 1500
-retry.maxDelayMs  = 12000
-```
-
-### 1.3 Output Structure
-
-```
-outputs/
-  generations/<timestamp>/
-  refinements/<timestamp>/
-  upscales/<timestamp>/
-  muses/<timestamp>/
-  videos/<timestamp>/
-  muses.json
-```
-
----
-
-## 2) Common Errors and Fixes
-
-### 2.1 Missing API Key
-
-**Symptom:** `Missing GEMINI_API_KEY in environment.`
-
-**Fix:** Add `GEMINI_API_KEY=...` to your `.env` and ensure it’s loaded.
-
-### 2.2 Model Overload / 429 / 503
-
-**Symptom:** Requests fail intermittently with overload/timeout errors.
-
-**Fix:** Retry automatically (built-in). If persistent, lower batch sizes or wait and re-run.
-
-### 2.3 Empty Output
-
-**Symptom:** `No image data returned from Gemini.`
-
-**Fix:** Re-run with simpler prompts, ensure input images are valid and not corrupted.
-
-### 2.4 Bad Paths
-
-**Symptom:** File not found errors for inputs.
-
-**Fix:** Ensure all image paths are absolute or relative to the repo root.
-
----
-
-## 3) Prompt Tips
-
-- Be explicit about jewelry fidelity (no extra jewelry, no fake sparkles).
-- Use clear lighting/mood cues.
-- Keep instructions scoped to avoid unintended changes.
-
----
-
-## 4) When to Disable Prompt Enhancement
-
-If the enhanced prompt drifts too far from your intent, set `enhancePrompt: false` and use a precise base prompt via selections and style hints.
-
----
-
-End of reference.
-
-## Related Skills
-
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-images.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-video.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\refine-images.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\muse-management.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\tired-girl.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\image-grid.md`
-- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\config-troubleshooting.md`
-