Ollama «does not support tools»: revisa las capacidades y cambia de modelo o arregla la plantilla (probado)
«does not support tools» indica que el modelo no tiene la capacidad tools. Revisa Capabilities con ollama show; la solución es un modelo con la etiqueta Tools o una plantilla con herramientas para el GGUF que importaste. Error y plantilla probados en Ollama 0.40.15; calidad real de las llamadas sin probar.

Respuesta corta: registry.ollama.ai/library/<modelo>:latest does not support tools significa que el modelo que elegiste no declara la capacidad de herramientas (tools), así que Ollama rechaza cualquier petición que lleve un arreglo tools. Compruébalo con ollama show <modelo>: la lista Capabilities tiene que incluir tools. La solución limpia es cambiar a un modelo que tenga la etiqueta Tools en ollama.com. Si importaste tu propio GGUF, la causa suele ser un TEMPLATE del Modelfile que nunca menciona herramientas. Reproduje el error en Ollama 0.40.15 con un modelo de prueba diminuto y probé tanto el error como un arreglo de la plantilla. No pude probar la calidad de las llamadas reales a herramientas, porque el archivo del modelo de prueba pesa solo 1,19 MB (unos 6 MB una vez cargado; stories260K.gguf en Hugging Face).
Qué dice el error
Este es el error tal como lo obtuve, tanto de la API nativa de Ollama como de la compatible con OpenAI. Ambas devolvieron HTTP 400:
{"error":"registry.ollama.ai/library/tiny:latest does not support tools"}
{"error":{"message":"registry.ollama.ai/library/tiny:latest does not support tools","type":"invalid_request_error","param":null,"code":null}}
La petición que lo provocó era una petición de chat normal con un campo tools añadido. El mismo modelo respondió al mismo chat sin tools con HTTP 200. Así que el modelo funciona; solo se rechaza la parte de herramientas. Muchas herramientas de agentes y asistentes de programación envían tools en cada petición, así que chocan con este error en cuanto las apuntas a un modelo sin la capacidad.
Paso 1: comprueba las capacidades del modelo
ollama show <modelo>
Con mi modelo de prueba, la salida terminaba así:
Capabilities
completion
Sin una línea tools, cualquier petición con tools fallará. Puedes leer la misma lista desde la API con POST /api/show, en el campo capabilities (el mío devolvió ['completion']). En un modelo que funciona, la lista incluye tools.
Solución 1: usa un modelo con la capacidad de herramientas
Es la solución correcta para casi todos. La búsqueda de modelos de Ollama tiene una categoría de herramientas: ollama.com/search?c=tools. Elige de esa lista un modelo que quepa en tu memoria, descárgalo y apunta tu herramienta a él. La documentación de llamadas a herramientas de Ollama usa qwen3 en sus ejemplos. Para tamaños y memoria, mira los mejores LLM locales y LLM locales para programar.
Solución 2: añadir una plantilla con herramientas a un modelo que importaste
Si importaste un GGUF con tu propio Modelfile y su TEMPLATE no maneja herramientas, Ollama no lista la capacidad. Lo probé. Con este Modelfile faltaba la capacidad:
FROM ./model.gguf
y con este, que solo menciona .Tools en la plantilla, la lista Capabilities ganó tools y la misma petición dejó de devolver el error:
FROM ./model.gguf
TEMPLATE """{{- if .Tools }}Tools: {{ .Tools }}
{{ end }}{{- range .Messages }}{{ .Role }}: {{ .Content }}
{{ end }}assistant: """
Tras ollama create my-model -f Modelfile, ollama show my-model listó completion y tools.
Lee bien los límites de esto:
- Solo probé que el error desaparece. Mi modelo de prueba es demasiado pequeño para llamar a una herramienta, así que no puedo decir nada sobre la calidad de las llamadas.
- La documentación del Modelfile de Ollama lista
.System,.Prompty.Responsecomo variables de plantilla y no describe.Tools. Lo que vi es el comportamiento de la versión 0.40.15. Tómalo como una observación, no como una garantía documentada. - Un modelo que nunca se entrenó para llamar a herramientas no será bueno en ello solo porque su plantilla las mencione. Usa la plantilla real de los autores del modelo, no una inventada como la mía.
Lo que no es
- No es un problema de memoria. Si ves «model requires more system memory», lee ese artículo.
- No es un fallo de red. Para «max retries exceeded» mira Ollama error max retries exceeded.
- No es el tamaño del contexto, aunque una lista larga de herramientas consume contexto. Mira longitud de contexto en Ollama.
Hay más mensajes en la lista de errores de Ollama y llama.cpp.
Preguntas frecuentes
¿Puedo desactivar las herramientas en mi cliente?
Si tu cliente permite desactivar las llamadas a herramientas o funciones, la petición no llevará tools, y mi modelo de prueba respondió con normalidad a una petición así. Muchas herramientas de agentes no funcionan sin herramientas, así que un modelo con la capacidad es la solución real.
¿Por qué falla en Ollama un modelo que admite herramientas en otros sitios?
Por lo que vi, Ollama lee la capacidad de los metadatos y de la plantilla del propio modelo. Los mismos pesos importados sin una plantilla con herramientas no mostraron la capacidad tools en mi prueba.
¿El endpoint compatible con OpenAI se comporta distinto?
Aquí no. Ambos endpoints devolvieron HTTP 400 con el mismo texto.
Fuentes y notas de prueba
- Documentación de Ollama: llamadas a herramientas (
docs.ollama.com/capabilities/tool-calling) y referencia del Modelfile (docs.ollama.com/modelfile). - Probado por mí: Ollama 0.40.15 en Linux con el modelo de prueba
stories260K.ggufde 1,19 MB: el error en/api/chaty/v1/chat/completions,ollama show,/api/showy una plantilla con{{ .Tools }}. - No probado: llamadas reales a herramientas, ningún modelo real de la biblioteca, Windows o macOS, aplicaciones cliente.
Relacionado: requisitos de GPU de Ollama según la VRAM.