~/tools / Arquivos de modelo e templates de chat / Ollama Modelfile Checker

Ollama Modelfile Checker — Verifique um Modelfile como o ollama create o lê

Cole um Modelfile do Ollama e veja se o ollama create vai aceitá-lo, antes de executá-lo. A ferramenta lê o arquivo como o Ollama faz e mostra a mensagem de erro do próprio Ollama com a linha, no que cada instrução se transforma, os parâmetros com os tipos que o Ollama guarda, as mensagens de exemplo e pontos de atenção, como um valor que termina antes da hora ou um TEMPLATE que o Ollama talvez não use. Nada sai do seu navegador.

Cole o arquivo inteiro. ollama show --modelfile <model> imprime o Modelfile de um modelo que você tem.

O ollama create consegue ler este Modelfile

Nenhum erro nas etapas que esta ferramenta consegue verificar. Se FROM e os arquivos existem só é verificado pelo ollama create no seu computador.

Notas

  • FROM qwen2.5:7b é um nome de modelo: o modelo precisa estar disponível para o Ollama.

No que as instruções se transformam

FROM
qwen2.5:7b
SYSTEM
You are a concise assistant. Answer in one or two sentences.
TEMPLATE
Não definido: vem do modelo de FROM

PARAMETER

NomeTipo no OllamaValor guardado
num_ctxint8192
stopstring[]["\u003c|im_end|\u003e"]
temperaturefloat320.7

A camada de parâmetros do novo modelo (JSON):

{"num_ctx":8192,"stop":["\u003c|im_end|\u003e"],"temperature":0.7}

Os parâmetros do modelo de FROM que você não define aqui também são mantidos.

MESSAGE (conversa de exemplo)

  1. userIs Toronto in Canada?
  2. assistantyes

O Modelfile como o Ollama o reescreve

Uma linha por instrução, sem comentários, no formato de Command.String no código-fonte do Ollama.

FROM qwen2.5:7b
PARAMETER num_ctx 8192
PARAMETER temperature 0.7
PARAMETER stop <|im_end|>
SYSTEM "
You are a concise assistant.
Answer in one or two sentences.
"
MESSAGE user Is Toronto in Canada?
MESSAGE assistant yes

Monte um Modelfile a partir de um formulário no Ollama Modelfile Generator →

Verificado em 2026-11-09 com o código-fonte do Ollama (v0.40.15), a sua documentação e o ollama create no Ollama 0.40.11: Ollama: Modelfile Reference · parser.go

Tudo é executado no seu navegador. Nada é enviado para lugar nenhum.

Um Modelfile parece simples, mas pequenos erros fazem o ollama create falhar com mensagens curtas como "unexpected EOF" ou "command must be one of ...". Esta ferramenta segue o código-fonte do Ollama passo a passo. Primeiro lê o arquivo com a mesma máquina de estados do analisador do Ollama: instruções em qualquer combinação de maiúsculas e minúsculas, valores que terminam no fim da linha a menos que comecem com " ou """, nomes de PARAMETER, papéis de MESSAGE e comentários. Depois faz o que o ollama create faz antes de contatar o servidor: para em ADAPTER e typical_p, verifica CAPABILITY e REQUIRES, e converte cada PARAMETER para o seu tipo como a API do Ollama faz (números inteiros, floats de 32 bits, true ou false, e stop como lista). Por fim, verifica o TEMPLATE com as regras de templates do Go, como o servidor faz. Mostra os parâmetros como o JSON que o novo modelo guarda, a conversa de exemplo e o Modelfile como o Ollama o reescreve. Verificamos a ferramenta com 43 Modelfiles no Ollama 0.40.11: em todos eles, ela deu o mesmo erro que o ollama create, ou os mesmos parâmetros guardados, mensagem de sistema, template, mensagens e licenças que o modelo que o ollama create fez.

Casos de uso

  • Descobrir por que o ollama create falha e qual linha causa isso
  • Verificar se parâmetros como num_ctx, temperature e stop são lidos como você pretendia, com os tipos que o Ollama guarda
  • Revisar um Modelfile de outra pessoa antes de criar um modelo a partir dele

Como usar

  1. Cole o seu Modelfile na caixa, ou edite o exemplo.
  2. Leia o resultado: ou o erro do ollama create com uma explicação, ou no que cada instrução se transforma.
  3. Veja as notas, como configurações dadas duas vezes ou um TEMPLATE sem ferramentas, e copie o Modelfile como o Ollama o reescreve, se precisar.

FAQ

O que significa "unexpected EOF"?

O Ollama chegou ao fim do arquivo no meio de algo. Em geral, um valor começa com " ou """ mas não termina com as mesmas aspas no fim de uma linha, então o Ollama continua lendo até o fim. Também acontece quando um nome de PARAMETER tem caracteres além de letras, dígitos e _, ou quando MESSAGE tem um papel mas nenhum texto.

Por que uma mensagem SYSTEM longa causa "command must be one of ..."?

Um valor termina no fim da sua linha. Se a mensagem tem mais linhas e não está entre """ (ou "), o Ollama lê a linha seguinte como uma nova instrução. Coloque valores de várias linhas entre """.

Os nomes de parâmetros diferenciam maiúsculas de minúsculas?

Sim. Instruções como FROM ou parameter podem estar em qualquer combinação de maiúsculas e minúsculas, mas os nomes de parâmetros devem ser escritos exatamente, como temperature. No nosso teste, PARAMETER Temperature 0.5 falhou com unknown parameter 'Temperature'.

A ferramenta verifica se o modelo em FROM existe?

Não. Ela não enxerga os modelos nem os arquivos do seu computador. Ela diz se FROM parece um nome de modelo ou um caminho, mas se ele existe só é verificado pelo ollama create.

Por que ADAPTER falha?

No Ollama 0.40, o ollama create para em uma linha ADAPTER com "LoRA adapters are no longer supported". ADAPTER não está na documentação atual do Modelfile.

O meu Modelfile é enviado para algum lugar?

Não. Tudo é executado no seu navegador.

Relacionados

Ollama Modelfile GeneratorOllama Template TesterOllama Model Info Reader