~/tools / Arquivos de modelo e templates de chat / Ollama Modelfile Generator
Ollama Modelfile Generator — Crie um Modelfile do Ollama: FROM, SYSTEM, PARAMETER, MESSAGE e mais
Crie um Modelfile do Ollama a partir de um formulário: o modelo base, uma mensagem de sistema, parâmetros como temperature e num_ctx, sequências de parada, mensagens de exemplo, um template, a versão mínima do Ollama, capacidades adicionais e uma licença. Os valores são verificados com a referência oficial do Modelfile e colocados entre aspas para que o Ollama os leia de volta sem alterações. Nada sai do seu navegador.
Template, versão mínima, capacidades e licença
Modelfile
FROM llama3.2 PARAMETER num_ctx 4096 PARAMETER temperature 1 SYSTEM """Answer in one short sentence.""" MESSAGE user Is Toronto in Canada? MESSAGE assistant yes
Comandos
Salve o texto acima como um arquivo chamado Modelfile no diretório atual e execute:
ollama create short-answers -f ./Modelfile ollama run short-answers
Instruções, parâmetros e valores padrão conforme a referência do Modelfile em 2026-11-09. Referência do Modelfile do Ollama
Tudo é feito no seu navegador. Nada do que você digita é enviado a lugar nenhum.
Um Modelfile é o projeto que o Ollama usa para criar um modelo com ollama create. Ele indica o modelo base com FROM e pode acrescentar uma mensagem de sistema, parâmetros, uma conversa de exemplo, um template de prompt, a versão mínima do Ollama, capacidades adicionais e uma licença. O formato é simples, mas alguns detalhes causam erros: PARAMETER só aceita os nomes da referência e cada um espera um número inteiro ou decimal, as sequências de parada são indicadas uma por linha, e o texto que ocupa várias linhas precisa ficar entre aspas triplas. Esta ferramenta escreve o arquivo para você. Ela lista apenas as instruções e os parâmetros da referência oficial do Modelfile, mostra o valor padrão de cada parâmetro ao lado do seu campo, avisa quando um valor seria rejeitado e coloca cada valor entre aspas do jeito que o próprio parser do Ollama o lê. Testamos a saída com o Ollama 0.40.11: criamos modelos a partir de arquivos gerados e os lemos de volta com ollama show --modelfile. REQUIRES e CAPABILITY foram verificados da mesma maneira. Ela também fornece os comandos ollama create e ollama run para o nome de modelo que você escolher.
A lógica principal desta ferramenta é de código aberto, sob a licença MIT. github.com/seigo5555/toolkitbox-lib/src/modelfile.ts
Casos de uso
- Fazer uma cópia de um modelo da biblioteca com a sua própria mensagem de sistema e a sua própria temperature, para executá-la com outro nome
- Definir uma janela de contexto maior (num_ctx) ou uma seed fixa para um modelo que você serve a partir de uma VPS
- Adicionar uma conversa de exemplo curta que mostre ao modelo como responder
Como usar
- Digite o modelo base em FROM: um modelo da biblioteca do Ollama (por exemplo llama3.2), o caminho de um arquivo GGUF ou um diretório com pesos Safetensors. Digite também o nome que você quer dar ao novo modelo.
- Escreva uma mensagem de sistema e preencha apenas os parâmetros que você quer mudar. Os campos vazios são omitidos, então os valores do modelo base continuam valendo. Adicione sequências de parada (uma por linha) e mensagens de exemplo, se precisar.
- Copie o Modelfile para um arquivo chamado Modelfile e execute os dois comandos mostrados abaixo: ollama create cria o modelo e ollama run o inicia.
O formato do Modelfile
Um Modelfile é um arquivo de texto com uma instrução e seus argumentos por linha. Linhas que começam com # são comentários. Segundo a referência oficial, as instruções não diferenciam maiúsculas de minúsculas e podem vir em qualquer ordem. Apenas FROM é obrigatória.
Um valor normalmente vai até o fim da linha. Um valor que ocupa várias linhas fica entre três aspas duplas ("""). O parser do Ollama (parser/parser.go) não tem nenhum mecanismo de escape, então, se """ aparecer no fim de uma linha dentro do seu texto, o valor termina ali. Nesse caso, a ferramenta mostra um erro.
Instruções
| Instrução | O que faz | Esta ferramenta |
|---|---|---|
| FROM | O modelo base: o nome de um modelo da biblioteca, um arquivo GGUF ou um diretório com pesos Safetensors | Compatível |
| PARAMETER | Parâmetros para executar o modelo | Compatível (os 11 da tabela da referência) |
| TEMPLATE | O template de prompt passado ao modelo, na sintaxe de templates do Go | Compatível |
| SYSTEM | A mensagem de sistema definida no template | Compatível |
| LICENSE | A licença do modelo | Compatível |
| MESSAGE | Uma conversa de exemplo, com os papéis system, user e assistant | Compatível |
| REQUIRES | A versão mínima do Ollama necessária | Compatível |
| CAPABILITY | Adiciona uma capacidade a um modelo GGUF ou MLX | Compatível |
Sobre CAPABILITY, a referência diz que decision só deve ser declarado para pesos treinados com os seus prompts. No nosso teste com o Ollama 0.40.11, os demais valores foram acrescentados às capacidades existentes do modelo, mas com decision apenas os valores declarados foram listados.
A documentação oficial não concorda sobre o valor padrão de num_ctx
Os valores padrão em cinza ao lado dos campos vêm da tabela da referência do Modelfile. Nela, num_ctx (o comprimento de contexto) é 2048, mas outras páginas da mesma documentação oficial dão valores diferentes.
| Página | Comprimento de contexto padrão |
|---|---|
| Referência do Modelfile | 2048 |
| FAQ | 4096 tokens |
| Context length | Depende da VRAM: 4k abaixo de 24 GiB, 32k de 24 a 48 GiB, 256k com 48 GiB ou mais |
Para ver o valor realmente em uso, execute ollama ps enquanto o modelo está carregado e olhe a coluna CONTEXT. Para fixar o valor, escreva PARAMETER num_ctx.
O que verificamos com o Ollama 0.40.11
Em 30 de outubro de 2026, executamos ollama create em arquivos gerados por esta ferramenta e os lemos de volta com ollama show --modelfile.
- Um decimal como 1.5 em um parâmetro inteiro (num_ctx e outros) faz o ollama create falhar com invalid int value.
- Texto em um parâmetro decimal (temperature e outros) falha com invalid float value.
- Formas como top_p 1e-1 e top_p .5 são aceitas, assim como seed -1.
- Um valor de SYSTEM entre """ mantém suas aspas duplas, uma aspa dupla no fim de uma linha e a sua indentação.
- Uma sequência de parada entre aspas duplas mantém os espaços do início e do fim.
- Se você omitir SYSTEM, o novo modelo mantém a mensagem de sistema do modelo base.
Verificando o modelo que você criou
- Crie o modelo com ollama create <nome> -f ./Modelfile.
- Execute ollama show --modelfile <nome> para ver o Modelfile como o Ollama o leu. Ele também mostra se as configurações que você omitiu receberam valores do modelo base.
- Inicie-o com ollama run <nome>.
Fontes (verificadas em 2026-11-09): Ollama: Modelfile Reference / Ollama: FAQ / Ollama: Context length / ollama/ollama: parser/parser.go
FAQ
Quais parâmetros posso definir?
Os listados na referência oficial do Modelfile: num_ctx, repeat_last_n, repeat_penalty, temperature, seed, stop, num_predict, draft_num_predict, top_k, top_p e min_p. A referência marca cada um como inteiro, número decimal ou string. No nosso teste com o Ollama 0.40.11, um decimal em um parâmetro inteiro falhou com invalid int value, e um texto em um parâmetro decimal falhou com invalid float value. A ferramenta mostra o mesmo problema antes de você executar ollama create.
Por que alguns valores ficam entre aspas triplas?
Em um Modelfile, um valor termina no fim da linha se não estiver entre aspas. O parser do Ollama lê um valor que começa com três aspas duplas até encontrar três aspas duplas no fim de uma linha, então o texto de várias linhas precisa ser envolvido assim. A ferramenta sempre envolve a mensagem de sistema, o template e a licença, e envolve uma mensagem de exemplo quando ela tem várias linhas, começa com aspas duplas, ou começa ou termina com um espaço. As sequências de parada ficam entre aspas duplas, então os espaços no início ou no fim são mantidos.
Meu texto pode conter três aspas duplas seguidas?
Não. O formato não tem caractere de escape, então três aspas duplas no fim de uma linha fecham o valor cedo demais, e a linha seguinte passa a ser lida como uma instrução, o que faz ollama create falhar. A ferramenta informa isso como um erro. Reescreva essa parte do texto.
O que acontece com as configurações que deixo vazias?
Elas não são escritas, e o novo modelo mantém o que herda do modelo base. Por exemplo, um modelo criado a partir de qwen2.5:7b sem SYSTEM mantém a mensagem de sistema de qwen2.5:7b. Execute ollama show --modelfile com o nome do modelo base para ver o que ele já define.
A ferramenta verifica se o modelo base existe?
Não. Ela não se conecta ao Ollama nem à biblioteca. Se o nome ou o caminho em FROM estiver errado, ollama create informa. Um caminho GGUF é lido em relação ao local do Modelfile, a menos que você indique um caminho absoluto.
Algo é enviado a um servidor?
Não. O Modelfile é montado no seu navegador.