Mover y migrar modelos de Ollama

Qué trata este artículo sobre migración de Ollama

• Cómo exportar e importar modelos de Ollama.
• Cómo transferir modelos a otra máquina.
• Qué archivos se encuentran en el directorio .ollama.
• Cómo sincronizar o replicar modelos.
• Consejos para la resolución de problemas.

Introducción: mover y migrar modelos de Ollama

Ollama almacena los modelos localmente en el directorio .ollama. Si estás configurando un sistema nuevo o quieres trasladar modelos de una máquina a otra, debes transferir estos archivos correctamente. Copiar el directorio completo suele ser suficiente, pero según la plataforma y versión hay detalles que tener en cuenta. Para transferencias ocasionales, Ollama también ofrece mecanismos propios de importación y exportación.

Este artículo muestra las formas más comunes de mover y migrar modelos de Ollama.

Términos clave

• Modelfile: Receta para un modelo con base, parámetros y plantilla.
• Blob: Archivo de pesos del modelo.
• Manifest: Archivo de metadatos que referencia blobs.
• .ollama: Directorio estándar para datos de Ollama.
• Export: Guardar un modelo en un archivo.
• Import: Cargar un modelo desde un archivo.
• rsync: Herramienta de sincronización de archivos.
• GGUF: Formato para pesos de modelos.

Dónde almacena Ollama los datos

Rutas estándar:

• Linux: ~/.ollama
• macOS: ~/.ollama
• Windows: C:\Users\<usuario>\.ollama

Estructura:

.ollama/
  models/
    manifests/
    blobs/

Empaquetar un modelo

Un modelo individual no se puede exportar directamente como paquete usando ollama show y ollama pull. Alternativamente, puedes copiar el directorio .ollama.

Copiar a una nueva máquina

Opción 1: Archivar

# En la máquina antigua
tar -czf ollama-backup.tar.gz -C ~/.ollama .

# En la máquina nueva
tar -xzf ollama-backup.tar.gz -C ~/.ollama

Ollama debe detenerse antes y reiniciarse después.

Opción 2: rsync sobre la red

rsync -avz --progress ~/.ollama/models/ nuevo-servidor:/home/usuario/.ollama/models/

Opción 3: Disco externo

# Copiar el directorio antiguo
cp -r ~/.ollama /ruta/al/respaldo/

# En la nueva máquina
cp -r /ruta/al/respaldo/.ollama ~/

Copiar solo modelos individuales

Si solo necesitas transferir algunos modelos, copiar los blobs directamente es complicado porque los manifests hacen referencia a ellos. Más simple:

1. Guardar el Modelfile en el sistema antiguo:

ollama show --modelfile llama3.1 > llama3.1.modelfile

2. Copiar el Modelfile y los blobs a la nueva máquina.
3. Reiniciar Ollama o ejecutar ollama create con el Modelfile.

Importar un modelo desde GGUF

ollama create mi-modelo -f ./Modelfile

Ejemplo de Modelfile:

FROM ./mi-modelo.gguf
PARAMETER temperature 0.7
SYSTEM "Asistente útil"

Detener Ollama antes de copiar

sudo systemctl stop ollama

Después de copiar:

sudo systemctl start ollama

Dependencia de plataforma

• Los modelos son independientes de la plataforma si están en el mismo formato.
• x86 y ARM necesitan sus respectivos binarios.
• Los controladores de GPU deben coincidir en el sistema destino.

Mantener la sincronización

Para varios sistemas, rsync o almacenamiento en red puede ayudar:

# Sincroniza .ollama entre dos hosts
rsync -avz --delete -e ssh host1:/home/usuario/.ollama/models/ /home/usuario/.ollama/models/

Consejos

• Verificar espacio disponible antes.
• Detener Ollama antes de copiar archivos.
• Ajustar permisos y usuario.
• Copiar también los manifests.
• Igualar versiones en ambos sistemas.
• Realizar respaldo antes de cambios importantes.

Obstáculos comunes

• Ollama ejecutándose durante la copia: Los archivos pueden corromperse.
• Permisos incorrectos: Ollama no puede leer los modelos.
• Falta el manifest: El modelo no aparece en ollama list.
• Espacio insuficiente: El destino no tiene almacenamiento suficiente.
• Versión incompatible: Una versión más nueva de Ollama puede requerir un formato diferente.
• Rutas de Windows: Prestar atención a barras diagonales y letras de unidad.

Enlaces e información adicional

• BotServ.de Ollama Backup
• BotServ.de Ollama Actualización de Modelos
• BotServ.de Ollama Ciclo de vida de modelos
• BotServ.de Comandos de Ollama

Preguntas frecuentes: mover modelos de Ollama

¿Puedo copiar simplemente el directorio .ollama? Sí, siempre que Ollama esté detenido y los permisos sean correctos.

¿Son compatibles los modelos entre Linux y macOS? Sí, los modelos GGUF son independientes de la plataforma.

¿Cómo transfiero solo un modelo? Copiar el Modelfile y los blobs asociados, o reimportarlos.

¿Funciona mediante USB? Sí, si los archivos se copian correctamente.

¿Debo reinstalar Ollama? Ollama debe estar instalado en el sistema destino, pero la configuración y datos pueden transferirse.

Fuentes y lecturas adicionales

• Ollama GitHub: https://github.com/ollama/ollama
• Formato GGUF: https://github.com/ggerganov/ggml/blob/master/docs/gguf.md
• CLI de Ollama: https://ollama.com/

Resumen: mover y migrar modelos de Ollama

Mover modelos de Ollama es más fácil a través del directorio .ollama. Antes debes detener Ollama para que los archivos permanezcan consistentes. Para modelos individuales, puedes transferir Modelfiles y blobs o reimportarlos. La independencia de plataforma, el espacio disponible, los permisos y las versiones de Ollama son los factores más importantes. Si tomas en cuenta estos puntos, puedes mover modelos rápidamente entre máquinas, servidores o respaldos.