## 🎭 Model Catalog

**GitHub:** `https://github.com/PauldeLavallaz/model_management`
**Local path:** `~/clawd/models-catalog/catalog/images/`

### Priority order
1. User provides model image → use directly
2. User describes model → search catalog, select best match
3. No specification → choose based on brief context

### Searching

## Creative Brief — How to Write It

Write it as a **real photography director's brief** — specific, physical, cinematic:

### Example: CasanCrem Light (ironic/viral UGC angle)

## Configuration Packs Reference

| Pack | Options |
|------|---------|
| `style_pack` | `premium_restraint`, `editorial_precision`, `cinematic_realism`, `cinematic_memory`, `campaign_hero`, `product_truth`, `clean_commercial`, `street_authentic`, `archive_fashion`, `experimental_authorial` |
| `shot_pack` | `full_body_wide`, `medium_shot`, `close_up`, `low_angle_hero`, `three_quarter`, `waist_up` |
| `camera_pack` | `arri_alexa35`, `canon_r5`, `hasselblad_x2d`, `leica_m6`, `sony_a1` |
| `lens_pack` | `cooke_anamorphic_i_50`, `leica_noctilux_50`, `zeiss_otus_55`, `wide_distortion_controlled` |
| `lighting_pack` | `golden_hour_backlit`, `natural_window`, `studio_three_point`, `bright_midday_sun` |
| `pose_discipline_pack` | `commercial_front_facing`, `street_style_candid_walk`, `sport_in_motion` |
| `film_texture_pack` | `kodak_portra_400`, `fujifilm_velvia_50`, `kodak_vision3_500t`, `digital_clean_no_emulation` |
| `color_science_pack` | `neutral_premium_clean`, `warm_golden_editorial`, `cinematic_low_contrast` |
| `environment_pack` | `beach_minimal`, `urban_glass_steel`, `street_crosswalk` — or custom descriptive string |
| `time_weather_pack` | `golden_hour_clear`, `bright_midday_sun`, `overcast_winter_daylight` |
| `branding_pack` | `logo_none` ← always unless logo explicitly requested |
| `intent` | `awareness`, `consideration`, `conversion`, `retention` |
| `aspect_ratio` | `9:16`, `16:9`, `1:1`, `4:5`, `3:4` |

## Python Upload Helper

## Troubleshooting

**Imagen negra/vacía** = filtro de moderación de Google/Gemini activado.
- No usar personas famosas o celebridades
- Modificar el brief eliminando referencias problemáticas

**API Key:** NO pasar como parámetro. Ya está configurado en ComfyDeploy.

## Integración con Portrait Generator

### Flujo de selección de modelo (actualizado)

El campo `model` puede venir de dos fuentes:

**Opción A — Catálogo (default):**

Usar cuando el guión no requiere rasgos muy específicos.

**Opción B — Portrait Generator (cuando el guión lo requiere):**

const response = await fetch("https://api.comfydeploy.com/api/run/deployment/queue", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    "deployment_id": "1e16994d-da67-4f30-9ade-250f964b2abc",
    "inputs": {
      "product": "/* product image URL */",
      "model":   "/* model face URL */",
      "brief":   "Detailed scene, pose, lighting, mood, product placement...",
      "target":  "Target audience: demographics, psychographics, lifestyle...",
      "input_seed": -1,
      "branding_pack": "logo_none",
      "aspect_ratio": "9:16",
      "style_pack": "street_authentic",
      "camera_pack": "sony_a1",
      "lens_pack": "zeiss_otus_55",
      "film_texture_pack": "kodak_portra_400",
      "color_science_pack": "warm_golden_editorial",
      "shot_pack": "medium_shot",
      "pose_discipline_pack": "street_style_candid_walk",
      "lighting_pack": "natural_window",
      "time_weather_pack": "golden_hour_clear",
      "environment_pack": "urban_glass_steel",
      "intent": "awareness"
    }
  })
});

# By body type
cat models-catalog/catalog/catalog.json | python3 -c "
import json,sys; data=json.load(sys.stdin)
for t in data['talents']:
    if t.get('body_type') in ['curvy','plus_size']:
        print(t['id'], t['name'], t['ethnicity'])
"
# By ethnicity + gender
cat models-catalog/catalog/catalog.json | jq '[.talents[] | select(.ethnicity == "hispanic" and .gender == "female") | {id, name, body_type}]'

Campaña UGC TikTok para CasanCrem Light La Serenísima.
Joven de contextura robusta sostiene el pote con sonrisa cómplice en cocina hogareña argentina.
Pose relajada, apoyada en la mesada, mirando directo a cámara con energía y complicidad.
El pote visible y protagonista en la mano. Luz de ventana natural, cálida de tarde.
Estilo UGC auténtico, no publicitario clásico. Cuerpo real, relatable, no atlético.

Oakley snowboarding campaign. Rider on metal rail in snowpark, body slightly rotated,
arms open for balance, eyes on the line. Technical authentic freestyle pose.
Alpine snowpark, full midday daylight, compacted snow, metal structures.
Natural sun bouncing off snow — saturated colors, strong contrast.
Documentary approach — freeze rider on rail, sharp body and board.
Real session frame: balance, concentration, style merged.

def comfy_upload(filepath: str, api_key: str) -> str:
    from pathlib import Path
    import requests
    p = Path(filepath)
    mime = "image/png" if p.suffix == ".png" else "image/jpeg"
    with open(p, "rb") as f:
        r = requests.post(
            "https://api.comfydeploy.com/api/file/upload",
            headers={"Authorization": f"Bearer {api_key}"},
            files={"file": (p.name, f, mime)},
            timeout=60
        )
    r.raise_for_status()
    return r.json()["file_url"]