Vous avez téléchargé un modèle et vous voulez qu’il réponde toujours dans un rôle précis, ou qu’il utilise une fenêtre de contexte adaptée à vos échanges ? Le Modelfile sert à enregistrer ces consignes et paramètres plutôt qu’à les retaper à chaque session. Il ne s’agit pas, à lui seul, d’un entraînement du modèle : vous partez généralement d’un modèle existant et en définissez une variante pour Ollama. Voici les directives utiles, un exemple à copier, puis les commandes pour créer et contrôler le résultat.
Que permet un Modelfile Ollama ?
Un Modelfile est un fichier texte qui décrit comment créer une variante de modèle avec Ollama. La directive FROM désigne la base ; SYSTEM ajoute une consigne de rôle ; PARAMETER définit des réglages de génération. D’autres directives existent, comme TEMPLATE pour le format complet du prompt, ou MESSAGE pour fournir un exemple de conversation. La documentation officielle du Modelfile.
Cette personnalisation agit sur la façon dont le modèle est invoqué, pas sur ses connaissances comme le ferait un nouvel entraînement. Par exemple, un rôle « assistant de dépannage PC » peut le pousser à poser des questions de diagnostic avant de proposer une piste ; cela ne garantit ni exactitude ni expertise. Pour situer ce sujet dans l’IA locale sur votre machine, retenez cette distinction entre consigne de comportement et apprentissage des poids.
Que faut-il choisir avant d’écrire le fichier ?
Commencez par choisir le modèle de base. Il doit déjà être disponible dans votre installation ou être accessible sous un nom reconnu par Ollama. La directive obligatoire s’écrit FROM nom-du-modele, éventuellement avec une étiquette de version, par exemple FROM llama3.2. Le nom montré ici est celui de l’exemple de la documentation, pas une recommandation de modèle.
Puis définissez un objectif observable. « Répondre en français et demander le système d’exploitation avant de proposer une commande » est testable ; « être meilleur » ne l’est pas. Rédigez une consigne concise qui indique le rôle, les contraintes utiles et la forme de réponse souhaitée. Évitez d’ajouter des consignes contradictoires ou des données confidentielles : le Modelfile est un fichier lisible comme un autre.
Enfin, ne réglez que les paramètres dont vous comprenez l’effet. temperature influence la diversité des réponses ; num_ctx fixe la taille de la fenêtre de contexte, c’est-à-dire la quantité de texte prise en compte pour générer la suite. Les valeurs par défaut documentées comprennent temperature 0.8, num_ctx 2048, repeat_last_n 64, top_k 40 et top_p 0.9. Ce sont les valeurs de référence indiquées par Ollama, non des réglages universels : les besoins varient selon le modèle et la tâche.
SYSTEM ou PARAMETER, que modifier en premier ?
Utilisez SYSTEM pour les consignes en langage naturel, comme « explique les étapes avant de donner une commande ». Choisissez PARAMETER pour un réglage technique pris en charge, avec sa valeur. Dans le tableau, les valeurs qualifiées d’exemples ne sont pas des prescriptions : essayez-les, puis comparez les sorties avec les mêmes questions.
| Besoin | Directive ou valeur d’exemple | À observer |
|---|---|---|
| Fixer un rôle | SYSTEM """…""" |
Le modèle suit-il le rôle sans ignorer la question ? |
| Ajuster la diversité | PARAMETER temperature 0.7 |
Les réponses sont-elles moins variables ou trop répétitives ? |
| Autoriser un contexte plus long | PARAMETER num_ctx 4096 |
Le modèle exploite-t-il les passages éloignés dans un long échange ? |
| Limiter la longueur générée | PARAMETER num_predict 256 |
La réponse s’arrête-t-elle à une longueur utile ? |
Les valeurs 0.7, 4096 et 256 ci-dessus sont des exemples de configuration, pas des valeurs par défaut garanties. Une fenêtre plus large peut demander davantage de mémoire selon le modèle et la configuration ; vérifiez l’usage réel sur votre machine au lieu de supposer qu’un chiffre plus élevé améliore tout. Ollama précise aussi que num_predict vaut -1 par défaut, ce qui correspond à une génération sans limite fixée par ce paramètre.
Comment écrire et créer sa variante ?
Dans un dossier de travail, créez un fichier nommé exactement Modelfile, sans extension supplémentaire. Voici un exemple minimal :
FROM llama3.2
PARAMETER temperature 0.7
PARAMETER num_ctx 4096
PARAMETER num_predict 256
SYSTEM """
Vous êtes un assistant de dépannage informatique.
Répondez en français, avec des étapes courtes.
Avant une commande qui dépend du système, demandez si nécessaire quel système est utilisé.
N’inventez pas de résultat de diagnostic.
"""
Remplacez llama3.2 par le nom du modèle choisi. Dans cet exemple, 0.7, 4096 et 256 sont des valeurs de départ pour l’essai, pas des recommandations applicables à tous les modèles. Gardez SYSTEM entre triples guillemets pour une consigne sur plusieurs lignes ; n’ajoutez TEMPLATE que si vous avez une raison précise de modifier le format d’entrée du modèle.
Depuis le dossier qui contient le fichier, créez une variante sous un nom distinct :
ollama create pc-assistant -f ./Modelfile
Puis lancez-la :
ollama run pc-assistant
La référence de l’éditeur décrit ollama create comme la commande de création à partir du Modelfile, avec -f suivi du chemin du fichier. Elle montre aussi la commande ollama run pour essayer le nom créé dans sa référence de l’interface en ligne de commande. Si le fichier porte un autre nom ou se trouve ailleurs, adaptez le chemin ; si FROM désigne un modèle non disponible localement, la création peut nécessiter que ce modèle soit récupéré.
Vous n’avez pas besoin de recopier le fichier dans chaque commande d’utilisation : le nom créé, ici pc-assistant, sert ensuite à lancer la variante. Si vous changez le fichier, relancez la création pour appliquer les modifications. En cas de doute sur l’état de votre installation, distinguez la mise à jour d’Ollama de celle des modèles : ce sont des opérations différentes.
Comment vérifier que les réglages sont appliqués ?
Ne vous contentez pas de voir la commande se terminer. Lancez le modèle et envoyez-lui deux ou trois demandes représentatives : une question simple, un cas où il doit demander une précision et une demande qui teste le format souhaité. Vérifiez qu’il respecte la consigne système, que la longueur reste utile et qu’il ne donne pas une réponse plus assurée que les informations disponibles.
Pour inspecter les informations enregistrées, utilisez :
ollama show pc-assistant
ollama show --modelfile pc-assistant
La seconde commande permet de voir le Modelfile associé au modèle. Comparez ce qui est affiché avec le fichier que vous avez écrit, notamment la base, le message système et les paramètres. Si la génération semble identique à avant, vérifiez d’abord le nom lancé, le chemin transmis à -f et la réussite de la commande de création ; testez ensuite une consigne dont l’effet est facile à constater.
Enfin, gardez l’essai local et n’exposez pas le service Ollama sur un réseau pour tester un simple Modelfile. Ce réglage ne rend pas les réponses fiables à lui seul et ne transforme pas le modèle en outil de diagnostic autonome. Si vous utilisez ensuite Ollama depuis un script, testez séparément l’application cliente et les échanges avec le modèle : la configuration décrite ici porte sur la variante créée, pas sur tous les appels possibles.
Questions fréquentes
Un Modelfile entraîne-t-il les poids du modèle ?
Non. Dans l’usage courant décrit ici, le Modelfile configure un modèle de base avec des consignes, un modèle de prompt ou des paramètres d’exécution. `ollama create` crée une variante Ollama ; cela ne signifie pas que les poids ont été réentraînés sur vos données. Pour adapter les poids, il faut un procédé d’entraînement ou un adaptateur compatible, ce qui est une opération différente.
Puis-je modifier un Modelfile après avoir créé le modèle ?
Oui. Modifiez le fichier, puis relancez `ollama create` avec le même nom de modèle et le chemin du fichier. Ensuite, exécutez à nouveau `ollama run` et vérifiez les réglages avec `ollama show`. Gardez une copie de la version précédente si vous souhaitez comparer le comportement ou revenir à une configuration connue.
Dois-je écrire moi-même la directive TEMPLATE ?
Pas pour commencer. Une directive `SYSTEM` suffit souvent pour fixer le rôle ou les consignes, tandis que le modèle de base fournit le format de conversation attendu. `TEMPLATE` décrit le prompt complet transmis au modèle et sa syntaxe dépend de celui-ci. Ne la remplacez que si vous savez quel format le modèle attend ; une structure incorrecte peut dégrader les réponses.
Un Modelfile peut-il contenir des informations confidentielles ?
Évitez d’y inscrire des mots de passe, clés d’API, données personnelles ou informations que vous ne voulez pas conserver dans un fichier local. Un Modelfile est un fichier texte ordinaire : toute personne pouvant le lire peut consulter son contenu. Gardez-le dans un emplacement privé et inspectez-le avant de le partager ou de le publier.
