Ollama list, pull, run: los comandos essentielles

Ollama se maneja en gran parte desde la terminal: ollama pull para descargar un modelo, ollama run para conversar con él, ollama list para ver qué está instalado. Esta guía reúne los comandos del día a día (pull, run, list, ps, show, stop, rm, create, cp) con un ejemplo por comando y cómo interpretar lo que muestran. Tenla abierta junto a la terminal durante las primeras semanas.
#Por qué aprender los comandos de Ollama
Ollama se ejecuta en segundo plano (el «servidor», que escucha en http://localhost:11434) y ofrece un pequeño programa de línea de comandos, ollama, que le envía órdenes. Las interfaces gráficas como Open WebUI pasan por el mismo servidor: saben chatear con un modelo, pero no siempre comprobar qué ocupa la memoria de la GPU, inspeccionar los parámetros de un modelo o hacer limpieza en el disco.
Nueve comandos cubren lo esencial. Se agrupan en tres familias: obtener y usar un modelo (pull, run), gestionar los modelos almacenados en el disco (list, show, rm, cp, create) y gestionar los cargados en memoria (ps, stop). Tener clara esta distinción entre disco y memoria evita la mayoría de las confusiones: un modelo puede estar descargado sin estar cargado, y cargado sin que estés hablando con él.
#Prerrequisitos
Aprovecha nuestra experiencia y un recorrido guiado para crear tu asistente local y usar tu IA en el día a día.
- Espacio en línea de por vida
- PDF + archivos
- Reembolsado 30 d
- Ollama instalado
- En Windows, macOS o Linux. Si aún no lo has hecho, sigue primero la guía de instalación (enlace al final de la página).
- Un terminal
- PowerShell o Terminal Windows, Terminal en macOS, cualquier shell en Linux. Los comandos son idénticos en los tres sistemas.
- El servidor en ejecución
- La aplicación Ollama en Windows y macOS, o el servicio systemd en Linux. Sin él, la mayoría de los comandos devuelven un error de conexión.
- Espacio en el disco
- Un modelo pequeño de 3B en Q4_K_M ocupa unos 2 GB; un 7B, unos 5 GB; un 14B, unos 9 GB.
El primer comando muestra la versión del cliente y, si el servidor responde, también la suya. El segundo lista todos los comandos disponibles en tu instalación: es la referencia que debes consultar si algún ejemplo de esta guía no te funciona.
#Paso 1 — ollama pull et ollama run: obtener y ejecutar un modelo
#ollama pull: télécharger
ollama pull descarga un modelo desde la biblioteca oficial (ollama.com/library) sin ejecutarlo. El nombre sigue el formato modelo:etiqueta. Sin etiqueta, Ollama usa latest, que en general apunta al tamaño y la cuantización propuestos por defecto, a menudo Q4_K_M.
Las etiquetas disponibles (tamaños, cuantizaciones como q8_0 o fp16) aparecen en la página de cada modelo en la biblioteca. Si la descarga se interrumpe, al volver a ejecutar el mismo comando se reanuda donde se había quedado.
#ollama run: conversar con un modelo
ollama run carga el modelo en memoria y abre una sesión de conversación en la terminal. Si el modelo todavía no está en el disco, run empieza por descargarlo: por lo tanto, pull no es obligatorio, pero permite preparar los modelos con antelación.
En la sesión interactiva, los comandos empiezan con una barra diagonal. Escribe /? para ver la lista completa en tu versión; los más útiles son los siguientes.
- /bye
- Salir de la sesión (Ctrl+D también funciona). El modelo permanece cargado en memoria unos minutos.
- /clear
- Borrar el historial de la conversación actual sin salir.
- /set parameter num_ctx 8192
- Cambiar un parámetro para la sesión, en este caso el tamaño del contexto. Útil para hacer pruebas antes de fijarlo en un Modelfile.
- /show info
- Mostrar la información del modelo cargado, como ollama show.
- """
- Abrir y luego cerrar un bloque de texto de varias líneas, práctico para pegar un fragmento largo.
Con --verbose, Ollama muestra después de cada respuesta tiempos y velocidades (entre ellas eval rate, en tokens por segundo). Es la forma más sencilla de medir la velocidad de un modelo en tu propio equipo, en lugar de fiarte de una cifra encontrada en otro sitio.
#Paso 2 — ollama list y ollama rm: gestionar los modelos en el disco
#ollama list: voir ce qui est installé
ollama list (o su alias ollama ls) muestra todos los modelos presentes en el disco. Es el comando que debes ejecutar antes de eliminar cualquier cosa y para encontrar el nombre exacto de un modelo que vayas a pasar a los demás comandos.
- NAME
- Nombre completo con su etiqueta. Es este nombre, tal cual, el que esperan run, show, rm o cp.
- ID
- Inicio de la huella del manifiesto. Dos nombres con el mismo ID designan el mismo modelo: es lo típico después de un ollama cp.
- SIZE
- Tamaño de los archivos del modelo en el disco. Da una idea aproximada de la memoria necesaria, pero la memoria que realmente ocupa una vez cargado es mayor (contexto, caché KV): es ollama ps el que la muestra.
- MODIFIED
- Fecha de la última descarga o de la última creación. Un modelo antiguo no está necesariamente desactualizado: vuelve a ejecutar pull para saber si existe una versión más reciente con la misma etiqueta.
Cuidado al sumar los tamaños: los modelos que comparten capas (un modelo y su copia, o un modelo personalizado creado a partir de otro) solo las almacenan una vez. Por eso, la suma de la columna SIZE puede superar el espacio realmente ocupado en la carpeta de modelos.
#ollama rm: eliminar un modelo
rm quita el modelo de la lista y elimina los archivos que ya no usa ningún otro modelo. No hay papelera ni confirmación: para recuperarlo, tendrás que volver a descargarlo. Para liberar espacio en disco a fondo o desinstalar Ollama, la guía de mantenimiento detalla los pasos a seguir según el sistema.
#Paso 3 — ollama ps y ollama stop: gestionar la memoria
Cuando sales de una sesión con /bye, el modelo no se descarga de inmediato: Ollama lo mantiene en memoria durante un tiempo (5 minutos por defecto, configurable con la variable de entorno OLLAMA_KEEP_ALIVE) para que la siguiente pregunta empiece sin espera. ollama ps muestra lo que está cargado en ese momento.
- SIZE
- Memoria ocupada por el modelo cargado, contexto incluido. Es mayor que el tamaño en disco que muestra ollama list.
- PROCESSOR
- La columna más útil. «100% GPU»: todo cabe en la VRAM, que es el caso ideal. Un reparto CPU/GPU significa que una parte del modelo se desborda a la memoria del sistema: la generación se ralentiza notablemente. «100% CPU»: no se usa ninguna GPU.
- UNTIL
- Momento en que el modelo se descargará si no recibe más solicitudes.
- CONTEXT
- Según la versión, una columna indica también el tamaño de contexto asignado. Si no aparece en tu caso, ollama show donne el valor configurado.
Si PROCESSOR indica un reparto CPU/GPU en un modelo que debería caber en tu tarjeta (por ejemplo, un 7B en Q4, de unos 5 GB, en una RTX 3060 de 12 GB), comprueba primero si no hay otro modelo cargado al mismo tiempo o un tamaño de contexto demasiado grande.
#ollama stop: descargar un modelo de la memoria
stop libera de inmediato la memoria ocupada por ese modelo, sin eliminarlo del disco. Es útil antes de abrir un juego, un programa de renderizado u otro modelo más grande. No lo confundas con rm: stop actúa sobre la memoria; rm, sobre el disco.
#Paso 4 — ollama show: inspeccionar un modelo
ollama show muestra la ficha de un modelo instalado: arquitectura, número de parámetros, longitud máxima de contexto, tamaño del embedding, cuantización, capacidades (herramientas, visión, razonamiento según el modelo), parámetros por defecto y licencia. Es lo primero que debes revisar antes de ajustar el tamaño de contexto o escribir un Modelfile.
- --parameters
- Parámetros de inferencia fijados por el autor del modelo. Si no aparece nada, se aplican los valores por defecto de Ollama.
- --modelfile
- Punto de partida ideal para personalizar un modelo: copia la salida en un archivo, modifícala y luego pásala a ollama create.
- --template
- Formato de mensajes que espera el modelo. Modifícalo solo si sabes por qué: una plantilla incorrecta degrada mucho las respuestas.
- --license
- Texto de la licencia. Léelo antes de cualquier uso comercial: no todas las licencias de los modelos open-weight son equivalentes.
- -v / --verbose
- En las versiones recientes, muestra metadatos adicionales del archivo del modelo.
#Paso 5 — ollama create et ollama cp: crear tus variantes
#ollama create: construire un modèle à partir d'un Modelfile
Un Modelfile es un pequeño archivo de texto que parte de un modelo existente y le añade un prompt de sistema, parámetros o una plantilla. ollama create le convierte en un nuevo modelo que aparece en ollama list. Las capas del modelo base se reutilizan: la variante casi no ocupa espacio en disco.
Si el archivo se llama exactamente Modelfile y está en la carpeta actual, la opción -f puede omitirse según la versión. ollama create sait también importar pesos en formato GGUF (FROM ./modele.gguf) o cuantizar un modelo en FP16 con la opción --quantize (-q), por ejemplo -q q4_K_M. Todas las instrucciones del Modelfile se detallan en la guía específica.
#ollama cp: copiar o renombrar
La copia comparte los mismos archivos que el original (mismo ID en ollama list). Sirve sobre todo para mantener un nombre estable en tus scripts o tu interfaz, o para congelar una versión antes de que un ollama pull qui la reemplace.
#Guía rápida: todos los comandos de Ollama de un vistazo
- ollama pull <modelo>
- Descargar o actualizar un modelo desde la biblioteca.
- ollama run <modelo> ["question"]
- Chatear en modo interactivo o hacer una sola pregunta. Descarga el modelo si falta. --verbose para ver las estadísticas.
- ollama list / ollama ls
- Listar los modelos presentes en el disco: nombre, ID, tamaño, fecha.
- ollama ps
- Listar los modelos cargados en memoria, cuánta ocupan y el reparto entre CPU y GPU.
- ollama show <modelo>
- Ficha del modelo; --parameters, --modelfile, --template, --system, --license.
- ollama stop <modelo>
- Descargar un modelo de la memoria sin eliminarlo.
- ollama rm <modelo>
- Eliminar un modelo del disco, sin confirmación.
- ollama create <nombre> -f Modelfile
- Crear un modelo personalizado; -q para cuantizar.
- ollama cp <source> <destination>
- Copiar un modelo con otro nombre.
- ollama serve
- Iniciar el servidor en primer plano (útil para depurar).
- ollama push <usuario>/<modelo>
- Publicar un modelo en ollama.com (se requiere una cuenta).
- ollama help [comando]
- Ayuda general o de un comando concreto; equivale a --help.
Las versiones recientes añaden otros comandos, relacionados sobre todo con la cuenta de ollama.com y los modelos alojados. Quedan fuera del alcance de esta guía rápida, centrada en el uso local: ollama help los muestra en tu versión.
#Solución de errores comunes
- 01«could not connect to ollama app» o «connection refused»El servidor no está en ejecución. Abre la aplicación Ollama (Windows, macOS) o inicia el servicio (Linux: sudo systemctl start ollama) y vuelve a intentarlo. Como último recurso, ejecuta ollama serve en una terminal aparte para leer los mensajes de error.
- 02«model not found» o «file does not exist»El nombre no corresponde a ningún modelo instalado. Ejecuta ollama list y copia el nombre exacto, etiqueta incluida: qwen2.5 se refiere a qwen2.5:latest, no a qwen2.5:14b.
- 03ollama list est vide alors que des modèles ont été téléchargésPuede que el cliente esté consultando otro servidor u otra carpeta de modelos: una variable OLLAMA_HOST distinta, OLLAMA_MODELS modificada o Ollama instalado dos veces (la aplicación y un contenedor Docker, por ejemplo). En un contenedor, los comandos se ejecutan dentro de él: docker exec -it ollama ollama list.
- 04El modelo responde muy lentamenteEjecuta ollama ps durante una generación. Si la columna PROCESSOR muestra una parte de CPU, el modelo no cabe por completo en la VRAM: descarga los demás modelos con ollama stop, reduce num_ctx o elige un tamaño o una cuantización más pequeños.
- 05El disco se llenaHaz un repaso con ollama list y elimina con ollama rm les los modelos que no uses. Para los casos más difíciles (archivos huérfanos, carpeta movida), consulta la guía de mantenimiento.
#Para ir más allá
Esta guía rápida trata la línea de comandos. La instalación, el mantenimiento y la personalización avanzada tienen cada uno su propia guía.
- Instalar Ollama
- Instalación paso a paso en Windows, macOS y Linux: https://quelllm.fr/guide/installer-ollama
- Actualizar, eliminar, desinstalar
- Actualizaciones según el sistema, recuperación de espacio en disco, desinstalación completa: https://quelllm.fr/guide/maintenance-ollama-update-supprimer
- Modelfile
- Todas las instrucciones para crear y personalizar un modelo con ollama create: https://quelllm.fr/guide/ollama-modelfile-personnalisation
- Entender Ollama
- Qué hace Ollama, cómo carga los modelos y a quién va dirigido: https://quelllm.fr/guide/ollama-debutant-c-est-quoi-comment-ca-marche
- Fuentes oficiales
- Referencia de la CLI: https://docs.ollama.com/cli; código y notas de la versión: https://github.com/ollama/ollama (no revisadas el 16 de noviembre de 2026; consulta el aviso al principio de la guía).
¿Un comentario, un error, una precisión? Avísanos, eso mejora la guía para todos.