Adaptadores LoRA
Cada entrenamiento que termina bien produce un adapter LoRA: el archivo con lo que tu modelo aprendió de tus datos. Aquí ves dónde vive, qué puedes hacer con él y qué exige tu plan.
¿Qué es un adapter?
Un adapter LoRA no es un modelo completo: es una capa ligera que se monta sobre un modelo base y lo especializa. Por eso pesa megabytes en lugar de gigabytes, y puedes tener varios sobre la misma base sin duplicar el modelo.
AstrApp entrena sobre el modelo base cargado en 4 bits, así que tus adapters aparecen con tipo QLoRA y cuantización 4bit. Además del adapter, el entrenamiento exporta por defecto el modelo en formato GGUF (cuantización q4_k_m) y lo guarda junto a él.
Qué ves en la página
Los adapters viven en Archivos › Adaptadores LoRA (/archivos/adaptadores).
- Resumen: total, listos, entrenando y fallidos.
- Filtros: búsqueda por nombre, estado y tipo (LoRA, QLoRA o Full).
- Lista: nombre, modelo base, tipo, tamaño, estado, loss final y fecha. Incluye los adapters de los proyectos de tu organización y los que creaste sin proyecto.
- Detalles de cada fila: almacenamiento, versión, si está publicado, el id del entrenamiento, la configuración con que se entrenó, las métricas finales y la información del dataset.
| Estado | Qué significa |
|---|---|
| Subiendo | La máquina está subiendo los archivos del adapter. |
| Listo | Los archivos están guardados y confirmados. Es el único estado que se puede descargar. |
| Entrenando | El adapter está registrado, pero sus archivos todavía no se confirman. |
| Fallido | El entrenamiento falló antes de terminar de subir el adapter. |
| Archivado | Lo archivaste. Sigue en la lista y conserva sus archivos. |
Qué puedes hacer y con qué plan
| Acción | Dónde | Plan |
|---|---|---|
| Ver, buscar y filtrar | Archivos › Adaptadores LoRA | Todos |
| Archivar | Botón Archivar de cada fila | Todos |
| Desarchivar | Solo por API | Todos |
| Descargar un adapter que entrenaste | Entrenar › Historial de entrenamientos, en el detalle del entrenamiento | Professional |
| Descargar un adapter de Entrenar por mí | Por API | Todos (en Gratuito, 1 al mes) |
| Publicar en Hugging Face | Al lanzar el entrenamiento, por API | Todos (con tu token de Hugging Face) |
Archivar y desarchivar
Archivar cambia el estado del adapter a Archivado sin borrar nada: sigue en la lista y puedes verlo aparte con el filtro de estado. En la pantalla solo hay botón para archivar; para devolverlo a Listo usa la API con "archived": false:
curl -X POST https://app.astrapp.lat/api/v1/adapters/ID_DEL_ADAPTER/archive \
-H "Authorization: Bearer sk_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{"archived": false}'{
"success": true,
"data": { "id": "ID_DEL_ADAPTER", "status": "ready" }
}Descargar un adapter que entrenaste
Descargar es sacar el adapter de AstrApp para servirlo en tu propia infraestructura.
Abre Entrenar › Historial de entrenamientos, entra al entrenamiento y haz clic en Descargar adapter. El botón se activa cuando el adapter está en Listo. La app abre una descarga por archivo (los pesos, su configuración y los GGUF que se hayan exportado); si tu navegador bloquea ventanas emergentes, permítelas para AstrApp.
Professional con suscripción activa
La descarga exige el plan Professional con suscripción activa. Si tu suscripción está cancelada o inactiva, para esta comprobación cuentas como Gratuito y la API responde 403 con el código PLAN_REQUIRED. La comprobación ocurre antes de generar los enlaces.
Por API
curl "https://app.astrapp.lat/api/v1/training/history/ID_DEL_ENTRENAMIENTO/download?type=adapter" \
-H "Authorization: Bearer sk_live_tu_api_key"| Campo | Qué trae |
|---|---|
adapterId | Id del adapter. |
adapterName | Nombre del adapter. |
files | Un elemento por archivo, con fileName, downloadUrl y size (bytes). |
expiresAt | Cuándo vencen los enlaces: una hora después de pedirlos. |
{
"error": "Descargar el adapter requiere el plan Professional con suscripción activa.",
"code": "PLAN_REQUIRED",
"requiredPlan": "professional"
}La misma ruta entrega, en todos los planes, los datos de entrenamiento (type=train), los de evaluación (type=eval) y un script de entrenamiento (type=script).
El botón Descargar de la lista
En Archivos › Adaptadores LoRA, el botón Descargar solo aparece si el adapter tiene un enlace de descarga guardado. Los adapters que entrenas en GPU se descargan desde el historial.
Adapters de Entrenar por mí
Los adapters que entrega el equipo aparecen en la misma lista. Descargarlos no exige Professional: la ruta GET /api/v1/dify/adapters/ID_DEL_ADAPTER/download devuelve el enlace del adapter. En el plan Gratuito tienes 1 descarga al mes; en los demás planes, sin límite. Más sobre el servicio en Entrenar por mí.
Publicar en Hugging Face
La app todavía no tiene un botón para publicar un adapter. Puedes pedirlo al lanzar el entrenamiento por API (POST /api/v1/gpu/instances/training):
hfRepoId: el repositorio de destino (usuario/nombre).autoPushHF: true: al terminar sube el adapter, los GGUF y una tarjeta del modelo. Si el repositorio no existe, se crea privado.ggufQuantizations(opcional, hasta 5): las cuantizaciones GGUF que quieres en lugar deq4_k_m.
Necesitas tu token de Hugging Face conectado en /settings/integrations: sin token la subida no ocurre.
Almacenamiento por plan
El espacio para adapters que incluye cada plan. Hoy la app no bloquea ni borra un adapter por pasarte de ese espacio.
| Plan | Almacenamiento LoRA |
|---|---|
| Gratuito | No incluido |
| Starter | 3 GB |
| Growth | 10 GB |
| Professional | Ilimitado |
Archiva lo que ya no uses
Entrenar es iterativo y vas a acumular versiones. Archivar mantiene ordenada la lista sin perder el historial.
La API por debajo
Estas rutas funcionan con tu sesión o con una API key.
Antes de cancelar tu plan
Para sacar de AstrApp los adapters que entrenaste (servirlos tú o no depender de la plataforma) necesitas Professional con suscripción activa. Descárgalos antes de cancelar. Exportar tus datasets en CSV, JSON y JSONL sí está disponible en todos los planes.