~/tools / File di modello e chat template / Ollama Modelfile Generator
Ollama Modelfile Generator — Crea un Modelfile di Ollama: FROM, SYSTEM, PARAMETER, MESSAGE e altro
Crea un Modelfile di Ollama da un modulo: il modello di base, un messaggio di sistema, parametri come temperature e num_ctx, sequenze di stop, messaggi di esempio, un template, la versione minima di Ollama, capacità aggiuntive e una licenza. I valori vengono controllati con il riferimento ufficiale del Modelfile e racchiusi tra virgolette in modo che Ollama li rilegga senza modifiche. Nulla lascia il tuo browser.
Template, versione minima, capacità e licenza
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
Comandi
Salva il testo qui sopra come file chiamato Modelfile nella directory corrente, poi esegui:
ollama create short-answers -f ./Modelfile ollama run short-answers
Istruzioni, parametri e valori predefiniti come indicati nel riferimento del Modelfile il 2026-11-09. Riferimento del Modelfile di Ollama
Tutto avviene nel tuo browser. Nulla di ciò che inserisci viene inviato da nessuna parte.
Un Modelfile è il progetto che Ollama usa per creare un modello con ollama create. Indica il modello di base con FROM e può aggiungere un messaggio di sistema, parametri, una conversazione di esempio, un template del prompt, la versione minima di Ollama, capacità aggiuntive e una licenza. Il formato è semplice, ma alcuni dettagli causano errori: PARAMETER accetta solo i nomi presenti nel riferimento e ognuno si aspetta un numero intero o decimale, le sequenze di stop si indicano una per riga, e il testo su più righe va racchiuso tra virgolette triple. Questo strumento scrive il file per te. Elenca solo le istruzioni e i parametri del riferimento ufficiale del Modelfile, mostra il valore predefinito di ogni parametro accanto al suo campo, ti avvisa quando un valore verrebbe rifiutato e racchiude ogni valore tra virgolette come lo legge il parser di Ollama stesso. Abbiamo provato l'output con Ollama 0.40.11: abbiamo creato modelli da file generati e li abbiamo riletti con ollama show --modelfile. REQUIRES e CAPABILITY sono stati controllati allo stesso modo. Ti fornisce anche i comandi ollama create e ollama run per il nome di modello che scegli.
La logica principale di questo strumento è open source, con licenza MIT. github.com/seigo5555/toolkitbox-lib/src/modelfile.ts
Casi d'uso
- Fare una copia di un modello della libreria con un tuo messaggio di sistema e una tua temperature, per eseguirla con un nuovo nome
- Impostare una finestra di contesto più grande (num_ctx) o un seed fisso per un modello che servi da un VPS
- Aggiungere una breve conversazione di esempio che mostra al modello come rispondere
Utilizzo
- Inserisci il modello di base in FROM: un modello della libreria di Ollama (per esempio llama3.2), il percorso di un file GGUF o una directory con pesi Safetensors. Inserisci anche il nome che vuoi dare al nuovo modello.
- Scrivi un messaggio di sistema e compila solo i parametri che vuoi cambiare. I campi vuoti vengono omessi, quindi restano validi i valori del modello di base. Aggiungi sequenze di stop (una per riga) e messaggi di esempio se ti servono.
- Copia il Modelfile in un file chiamato Modelfile ed esegui i due comandi mostrati sotto: ollama create costruisce il modello e ollama run lo avvia.
Il formato del Modelfile
Un Modelfile è un file di testo con un'istruzione e i suoi argomenti per riga. Le righe che iniziano con # sono commenti. Secondo il riferimento ufficiale, le istruzioni non distinguono tra maiuscole e minuscole e possono essere in qualsiasi ordine. Solo FROM è obbligatoria.
Un valore di norma arriva fino alla fine della riga. Un valore che occupa più righe va racchiuso tra tre virgolette doppie ("""). Il parser di Ollama (parser/parser.go) non ha alcun meccanismo di escape, quindi se """ compare alla fine di una riga all'interno del tuo testo, il valore termina lì. In quel caso lo strumento mostra un errore.
Istruzioni
| Istruzione | Cosa fa | Questo strumento |
|---|---|---|
| FROM | Il modello di base: il nome di un modello della libreria, un file GGUF o una directory con pesi Safetensors | Supportato |
| PARAMETER | Parametri per l'esecuzione del modello | Supportato (gli 11 della tabella di riferimento) |
| TEMPLATE | Il template del prompt passato al modello, nella sintassi dei template di Go | Supportato |
| SYSTEM | Il messaggio di sistema impostato nel template | Supportato |
| LICENSE | La licenza del modello | Supportato |
| MESSAGE | Una conversazione di esempio, con i ruoli system, user e assistant | Supportato |
| REQUIRES | La versione minima di Ollama richiesta | Supportato |
| CAPABILITY | Aggiunge una capacità a un modello GGUF o MLX | Supportato |
Per CAPABILITY, il riferimento dice di dichiarare decision solo per pesi addestrati per i suoi prompt. Nel nostro test con Ollama 0.40.11, gli altri valori sono stati aggiunti alle capacità esistenti del modello, ma con decision sono stati elencati solo i valori dichiarati.
La documentazione ufficiale non è d'accordo sul valore predefinito di num_ctx
I valori predefiniti in grigio accanto ai campi provengono dalla tabella del riferimento del Modelfile. Questa indica 2048 per num_ctx (la lunghezza del contesto), ma altre pagine della stessa documentazione ufficiale riportano valori diversi.
| Pagina | Lunghezza del contesto predefinita |
|---|---|
| Riferimento del Modelfile | 2048 |
| FAQ | 4096 token |
| Lunghezza del contesto | Dipende dalla VRAM: 4k sotto i 24 GiB, 32k tra 24 e 48 GiB, 256k da 48 GiB in su |
Per vedere il valore effettivamente in uso, esegui ollama ps mentre il modello è caricato e guarda la colonna CONTEXT. Per fissare il valore, scrivi PARAMETER num_ctx.
Cosa abbiamo verificato con Ollama 0.40.11
Il 30 ottobre 2026 abbiamo eseguito ollama create su file generati da questo strumento e li abbiamo riletti con ollama show --modelfile.
- Un decimale come 1.5 in un parametro intero (num_ctx e altri) fa fallire ollama create con invalid int value.
- Un testo in un parametro decimale (temperature e altri) fallisce con invalid float value.
- Forme come top_p 1e-1 e top_p .5 sono accettate, così come seed -1.
- Un valore SYSTEM racchiuso tra """ mantiene le sue virgolette doppie, una virgoletta doppia a fine riga e il suo rientro.
- Una sequenza di stop racchiusa tra virgolette doppie mantiene gli spazi iniziali e finali.
- Se ometti SYSTEM, il nuovo modello mantiene il messaggio di sistema del modello di base.
Verificare il modello che hai creato
- Crea il modello con ollama create <nome> -f ./Modelfile.
- Esegui ollama show --modelfile <nome> per vedere il Modelfile come lo ha letto Ollama. Mostra anche se le impostazioni che hai omesso hanno preso i valori dal modello di base.
- Avvialo con ollama run <nome>.
Fonti (verificate il 2026-11-09): Ollama: Modelfile Reference / Ollama: FAQ / Ollama: Context length / ollama/ollama: parser/parser.go
FAQ
Quali parametri posso impostare?
Quelli elencati nel riferimento ufficiale del Modelfile: num_ctx, repeat_last_n, repeat_penalty, temperature, seed, stop, num_predict, draft_num_predict, top_k, top_p e min_p. Il riferimento indica per ciascuno se è un intero, un numero decimale o una stringa. Nella nostra prova con Ollama 0.40.11, un decimale in un parametro intero è fallito con invalid int value, e un testo in un parametro decimale è fallito con invalid float value. Lo strumento segnala lo stesso problema prima che tu esegua ollama create.
Perché alcuni valori sono racchiusi tra virgolette triple?
In un Modelfile, un valore termina alla fine della sua riga se non è tra virgolette. Il parser di Ollama legge un valore che inizia con tre virgolette doppie finché non trova tre virgolette doppie a fine riga, quindi il testo su più righe va racchiuso così. Lo strumento racchiude sempre il messaggio di sistema, il template e la licenza, e racchiude un messaggio di esempio quando ha più righe, inizia con una virgoletta doppia, oppure inizia o finisce con uno spazio. Le sequenze di stop sono racchiuse tra virgolette doppie, così gli spazi all'inizio o alla fine vengono mantenuti.
Il mio testo può contenere tre virgolette doppie di seguito?
No. Il formato non ha un carattere di escape, quindi tre virgolette doppie a fine riga chiudono il valore troppo presto, e la riga successiva viene letta come istruzione, il che fa fallire ollama create. Lo strumento lo segnala come errore. Riscrivi quella parte del testo.
Cosa succede alle impostazioni che lascio vuote?
Non vengono scritte, e il nuovo modello mantiene ciò che eredita dal modello di base. Per esempio, un modello creato da qwen2.5:7b senza SYSTEM mantiene il messaggio di sistema di qwen2.5:7b. Esegui ollama show --modelfile con il nome del modello di base per vedere cosa imposta già.
Lo strumento verifica che il modello di base esista?
No. Non contatta Ollama né la libreria. Se il nome o il percorso in FROM è sbagliato, ollama create lo segnala. Un percorso GGUF viene letto in relazione alla posizione del Modelfile, a meno che tu non indichi un percorso assoluto.
Viene inviato qualcosa a un server?
No. Il Modelfile viene composto nel tuo browser.