~/tools / Ejecutar un LLM local en tu servidor / Ollama Model Info Reader

Ollama Model Info Reader — Lee ollama show: contexto, capas, capacidades, licencia, caché KV

Pega la respuesta de /api/show de un modelo de Ollama, o la salida de ollama show o ollama show --verbose, y ve el modelo de un vistazo: tamaño, cuantización, la longitud de contexto máxima que admite, capas y cabezas de atención, qué puede hacer (tools, vision, thinking, embeddings y más), sus parámetros por defecto, el system prompt y la licencia. La herramienta también calcula la caché KV para cada longitud de contexto, la memoria que crece con num_ctx. Nada sale de tu navegador.

Cómo obtenerlo

Sustituye qwen2.5:7b por tu modelo. Ambos funcionan mientras Ollama está en ejecución.

curl http://localhost:11434/api/show -d '{"model": "qwen2.5:7b"}'

ollama show qwen2.5:7b --verbose

Leído como una respuesta de /api/show.

  • El tamaño de cabeza no está en los metadatos, así que se calcula como embedding_length ÷ head_count = 128.

Modelo

Nombre
Qwen2.5 7B Instruct
Arquitectura
qwen2
Parámetros
7.62B
Cuantización
Q4_K_M
Contexto máximo
32768
Capas
28
Cabezas de atención
28 (KV: 4)
Tamaño de cabeza
128
Longitud del embedding
3584
Origen de la plantilla
go_template

Capacidades

  • completionGenera texto con /api/generate y /api/chat.
  • toolsAcepta tools, así que puede llamar a funciones.

Caché KV por longitud de contexto

En f16, el tipo por defecto. Esta memoria se suma a la de los pesos.

Contexto (tokens)Caché KV
2048112 MiB
4096el valor por defecto de la FAQ de Ollama224 MiB
8192448 MiB
16384896 MiB
32768máximo admitido1792 MiB

Suma los pesos en el Local LLM Memory Estimator →

System prompt

You are Qwen, created by Alibaba Cloud. You are a helpful assistant.

Licencia

general.license
apache-2.0
general.license.link
https://huggingface.co/Qwen/Qwen2.5-7B-Instruct/blob/main/LICENSE
Apache License
...

Caché KV = 2 × capas × cabezas KV × tamaño de cabeza × 2 bytes (f16) × longitud de contexto. Los valores coincidieron con el log de Ollama en nuestras pruebas. La FAQ de Ollama dice que q8_0 usa cerca de la mitad y q4_0 cerca de una cuarta parte de f16 (se configura con OLLAMA_KV_CACHE_TYPE, con Flash Attention).

El contexto máximo es lo que admite el modelo, no lo que usa Ollama. La FAQ de Ollama da 4096 tokens como valor por defecto; num_ctx en una petición o en el modelo, u OLLAMA_CONTEXT_LENGTH en el servidor, lo cambia.

Campos de la referencia de la API y del código fuente de Ollama (v0.40.15), comprobados con Ollama 0.40.11 el 2026-11-07. Ollama: Show model details

Todo se hace en tu navegador. La herramienta no se conecta a nada.

ollama show y el endpoint /api/show describen un modelo instalado, pero los datos más útiles están repartidos en una larga lista de metadatos GGUF: el número de capas es <architecture>.block_count, la longitud de contexto máxima es <architecture>.context_length, y las cabezas de atención que deciden el tamaño de la caché KV son attention.head_count y attention.head_count_kv. Esta herramienta lee el JSON de /api/show, o el texto de ollama show (la versión corta o --verbose), y reúne esos datos en un solo lugar. Lista las capacidades con lo que significa cada una, usando los nombres del código fuente de Ollama (v0.40.15): completion, tools, insert, vision, embedding, thinking, image, audio, decision y speech. Para los modelos con thinking muestra los valores que acepta think y el valor por defecto. Muestra los parámetros definidos en el modelo, como stop, temperature o num_ctx, el system prompt y la licencia. A partir de las capas, las cabezas KV y el tamaño de cabeza calcula la caché KV en f16, el tipo por defecto: 2 (claves y valores) × capas × cabezas KV × tamaño de cabeza × 2 bytes × longitud de contexto. Comprobamos esta fórmula con el propio log de Ollama: para qwen2.5:7b, 224 MiB con 4096 tokens y 448 MiB con 8192, y para qwen2.5:0.5b, 48 MiB con 4096 y 384 MiB con 32768. El tamaño de cabeza sale de attention.key_length cuando el modelo lo tiene, y si no, de embedding_length dividido entre head_count. Los modelos con ventana deslizante o con capas que comparten su caché KV usan menos de lo que muestra la tabla; la herramienta lo indica en lugar de adivinar. Probamos la herramienta con la salida real de /api/show, ollama show y ollama show --verbose para qwen2.5:7b en Ollama 0.40.11, y con el ejemplo de la referencia de la API de Ollama.

La lógica principal de esta herramienta es de código abierto, con licencia MIT. github.com/seigo5555/toolkitbox-lib/src/ollama-show.ts

Casos de uso

  • Saber si un modelo admite tools, imágenes o thinking antes de construir sobre él
  • Ver la longitud de contexto máxima que admite un modelo y cuánta memoria necesita la caché KV con cada longitud
  • Revisar la licencia, los parámetros por defecto y el system prompt que trae un modelo

Cómo usarlo

  1. Ejecuta curl http://localhost:11434/api/show con el nombre del modelo, o ollama show con --verbose.
  2. Pega la salida. La herramienta detecta cuál de las tres formas es.
  3. Lee el resumen del modelo, las capacidades y la tabla de la caché KV. Abre el estimador de memoria para sumar los pesos.

FAQ

¿Por qué no se muestra la caché KV con lo que pegué?

La salida corta de ollama show no incluye las capas ni las cabezas de atención. Pega la respuesta de /api/show o la salida de ollama show --verbose.

El modelo admite 32768 tokens. ¿Por qué Ollama usa menos?

La longitud de contexto de los metadatos es la máxima para la que se entrenó el modelo. La FAQ de Ollama dice que la ventana de contexto por defecto es de 4096 tokens; el código fuente y el log del servidor de Ollama muestran que el servidor elige un valor por defecto según la memoria de la GPU. Una petición puede fijar num_ctx, el modelo puede fijarlo en sus parámetros y el servidor puede fijar OLLAMA_CONTEXT_LENGTH.

¿Qué tan exacto es el tamaño de la caché KV?

Para modelos sin ventana deslizante ni capas KV compartidas, la fórmula dio exactamente los tamaños del log de Ollama en nuestras pruebas (224 MiB para qwen2.5:7b con 4096 tokens). Es para el tipo por defecto f16; la FAQ de Ollama dice que q8_0 usa cerca de la mitad y q4_0 cerca de una cuarta parte, con Flash Attention activado.

¿Cuál es la diferencia entre los parámetros y la longitud de contexto?

La longitud de contexto viene del archivo del modelo y es el máximo. Parámetros como num_ctx, temperature o stop son valores por defecto definidos en el Modelfile del modelo; las peticiones pueden sustituirlos.

¿Qué significa el origen de la plantilla?

Indica de dónde viene el prompt de chat, por ejemplo go_template para una plantilla Go incluida en el modelo o renderer para un renderizador integrado en Ollama. Los valores aparecen en la referencia de la API de Ollama.

¿Se envían mis datos a algún sitio?

No. La salida se lee en tu navegador.

Artículos relacionados

Relacionados