THE BLACKCAT Photo Fix Studio

# THE BLACKCAT Photo Fix Studio

THE BLACKCAT Photo Fix Studio arregla una foto con Higgsfield Nano Banana Pro
(modelo `nano_banana_2`): borra el glare de los anteojos, borra un objeto,
limpia el fondo o mejora la nitidez y la luz. Una foto entra, una foto arreglada
sale.

Este Studio es un dashboard local mas un wrapper de shell sobre una API externa
paga. No corre inferencia de AI local. El arreglo arranca solo cuando el
operador aprieta "Arreglar" y confirma el costo.

## cost_note

- Cada arreglo gasta creditos reales de Higgsfield.
- Estimado: aproximadamente **2 creditos por foto** (Nano Banana Pro edicion de
  imagen, segun las lecciones del proyecto).
- El costo va visible en el boton ("Arreglar - 2 creditos") y hay una
  confirmacion previa antes de disparar.

## Dashboard local

- URL: `http://127.0.0.1:8779`
- Launcher: `scripts/open-photo-fix-studio.command`
- Carpeta del Studio: `studios/photo-fix-studio/`
- Carpeta de entrada: `studios/photo-fix-studio/input/`
- Carpeta de salida: `studios/photo-fix-studio/output/`
- Logs: `studios/photo-fix-studio/output/_logs/`

## Que hace

1. Toma una foto JPG/PNG del dropzone (o una ya cargada en `input/`).
2. Arma el prompt segun el arreglo elegido.
3. La manda a `higgsfield generate create nano_banana_2 --image ... --prompt ... --wait --json`.
4. Espera el resultado en la nube.
5. Descarga la foto arreglada a `output/`.
6. Muestra antes / despues lado a lado y ofrece la descarga.

## Arreglos

- **Borrar glare de anteojos**: saca los reflejos de los lentes y mantiene los
  ojos y la cara identicos y fotorrealistas.
- **Borrar un objeto**: el operador describe que borrar en un campo de texto; el
  resto de la imagen queda igual.
- **Limpiar fondo**: saca elementos que distraen del fondo, mantiene el sujeto
  identico.
- **Mejorar nitidez y luz**: mejora nitidez, exposicion y detalle sin cambiar la
  identidad.

## Setup por unica vez

```bash
export PATH="$HOME/.local/bin:$PATH"
higgsfield auth login
higgsfield account balance
```

El login es device-login por navegador. El token vive en:

```text
~/.config/higgsfield/credentials.json
```

Nunca commitees ni imprimas ese archivo.

## Comando de terminal

```bash
studios/photo-fix-studio/photo-fix.sh \
  --image studios/photo-fix-studio/input/foto.jpg \
  --out studios/photo-fix-studio/output/foto-fixed.png \
  --prompt "Remove the glare and reflections from the eyeglasses lenses. Keep the eyes natural and the face identical."
```

## Codigos de salida del wrapper

- `0`: OK, foto arreglada descargada.
- `1`: foto no encontrada, formato invalido, sin prompt, sin URL en la respuesta,
  o fallo de descarga.
- `2`: argumento desconocido.
- `127`: CLI de Higgsfield no instalado.

## Notas de seguridad

- El arreglo usa creditos reales de Higgsfield.
- El auth de Higgsfield puede expirar y puede pedir `higgsfield auth login` de
  nuevo.
- Manten la concurrencia baja. Higgsfield rate-limitea alrededor de tres jobs.
- Revisa siempre caras, manos y texto por warping.
- No commitees fotos de entrada, fotos de salida, JSON logs, err logs ni
  credenciales. Las carpetas `input/` y `output/` estan git-ignored.