Documentation Index
Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
Use this file to discover all available pages before exploring further.
Descarga el nuevo modelo antes de actualizar. La descarga automática de modelos está deshabilitada por defecto en 1.55. Si actualizas primero la plataforma, los servicios de IA no arrancarán.
Qué cambió
La versión 1.55 incluye una nueva familia de modelos por defecto. Esto implica lo siguiente:
- Qwen 3 está deprecado. Todos los presets baseline ahora usan Qwen 3.5.
- La descarga automática de modelos está deshabilitada. El nuevo modelo no se descargará solo, así que debes descargarlo manualmente antes de actualizar.
- Los presets de visión están deprecados. Qwen 3.5 ya incluye soporte nativo de imágenes, por lo que
alternatives.baseline-48g-vision y alternatives.baseline-96g-vision ya no existen. Se reemplazan por sus equivalentes baseline.
- Infraestructura de monitorizacion activada por defecto:
monitoring: true es el valor por defecto. Esto instala los servicios de monitorización (Prometheus, Grafana, node-exporter, k8s-monitoring) a pesar de que las métricas hayan sido desactivadas. Ninguna métrica es enviada sin ser activada explicitamente, pero la infraestructura será instalada. Si no quieres que se instale, añade lo siguiente al fichero de configuración:
observability:
monitoring: false
Cómo actualizar
Paso 1: Verifica tu preset actual
sudo cat /etc/zylon/zylon-conf.yaml | grep preset
Paso 2: Identifica el nuevo modelo
Usa la siguiente tabla para identificar el modelo que debes descargar antes de actualizar.
Presets estándar
| Preset actual | Modelo a descargar |
|---|
baseline-24g | cyankiwi/qwen3.5-9b-awq-4bit |
baseline-32g | cyankiwi/qwen3.5-9b-awq-4bit |
baseline-48g | txn545/qwen3.5-35b-a3b-nvfp4 |
baseline-96g | cyankiwi/qwen3.5-27b-awq-4bit |
Si estás usando un preset de visión, actualiza tu zylon-conf.yaml al nuevo preset antes de descargar el modelo.
| Preset actual | Cambiar a | Modelo a descargar |
|---|
alternatives.baseline-48g-vision | baseline-48g | txn545/qwen3.5-35b-a3b-nvfp4 |
alternatives.baseline-96g-vision | baseline-96g | cyankiwi/qwen3.5-27b-awq-4bit |
Paso 3: Descarga el modelo y actualiza
Sigue los pasos según tu tipo de instalación.
Online
Semi-Airgap
Airgap Completo
Actualiza la CLI (obligatorio)
sudo zylon-cli self-update
sudo zylon-cli version
Descarga el modelo
Reemplaza <model_id> por el valor de la tabla anterior.sudo zylon-cli models download <model_id>
Instala 1.55
sudo zylon-cli list-versions
sudo zylon-cli install 1.55.X
Actualiza la CLI (obligatorio)
sudo zylon-cli self-update
sudo zylon-cli version
Rehabilita acceso a internet
Permite temporalmente operaciones online en la configuración y aplícalo:airgap:
offlineOperation: false
Verifica conectividad
sudo zylon-cli preflight --network -v
Descarga el modelo
sudo zylon-cli models download <model_id>
Instala 1.55
sudo zylon-cli list-versions
sudo zylon-cli install 1.55.X
Vuelve a activar modo offline
airgap:
offlineOperation: true
Estos pasos se ejecutan en dos máquinas: una con internet para descarga y la máquina destino offline.Máquina online: actualiza la CLI (obligatorio)
sudo zylon-cli self-update
sudo zylon-cli version
Máquina online: descarga y exporta el modelo
sudo zylon-cli models download --no-install <model_id>
sudo zylon-cli models export
Máquina online: prepara el paquete de transferencia de la CLI
sudo tar -czf zylon-update.tar.gz \
/usr/local/bin/zylon-cli \
/usr/local/bin/zylon-forge-cli
Máquina online: exporta el bundle de plataforma 1.55
sudo zylon-cli list-versions
# Usa --from si conoces tu versión actual (bundle más pequeño)
sudo zylon-cli export 1.55.X --from CURRENT_VERSION
# Si no, exporta un bundle completo
sudo zylon-cli export 1.55.X
Transfiere artefactos a la máquina offline
Transfiere los archivos necesarios:
zylon-models-*.tarzylon-*.tarzylon-update.tar.gz
Máquina offline: extrae el paquete de actualización CLI
cd /tmp
sudo tar -xzf zylon-update.tar.gz -C /
sudo chmod +x /usr/local/bin/zylon-cli /usr/local/bin/zylon-forge-cli
sudo zylon-cli version # Debería mostrar 2.3.0 o posterior
Máquina offline: importa e instala
# Importa el modelo y luego instálalo en runtime offline
sudo zylon-cli models import zylon-models-*.tar
sudo zylon-cli models download --offline <model_id>
# Importa el bundle de Zylon, verifica la versión y luego instala
sudo zylon-cli import zylon-*.tar
sudo zylon-cli list-versions --offline
sudo zylon-cli install 1.55.X --airgap
