---
name: lora_ref
lang: py
domain: ml
version: "1.0.0"
algebraic: product
definition: |
  class LoraRef(BaseModel):
      path: str
      weight: float = 1.0
      scale: float | None = None
description: "Referencia a un adaptador LoRA para generacion de imagenes. Especifica ruta, peso global y override de alpha. Inmutable."
tags: [ml, diffusion, lora, adapter, fine-tuning, stable-diffusion]
uses_types: []
file_path: "python/functions/ml/lora_ref.py"
---

## Notas

Tipo producto inmutable. Fallback a `dataclass(frozen=True)` si pydantic no esta instalado.

`weight` controla cuanto influye el LoRA en la imagen generada:
- 0.0 — LoRA completamente desactivado (como si no estuviera).
- 1.0 — fuerza original del LoRA (lo que el autor recomienda tipicamente).
- >1.0 — sobre-aplicacion: puede producir artefactos o saturacion del estilo.

`scale` es el override del alpha (escala del rango): si el archivo del LoRA tiene `alpha=16` y `rank=32`, el factor efectivo es `alpha/rank = 0.5`. Pasar `scale=1.0` fuerza factor 1.0 independientemente del alpha interno.

Multiples LoRAs se listan en `GenerationConfig.loras` en orden de aplicacion. Los backends los aplican secuencialmente.
