Ollama exécute des modèles d'IA, Llama, Mistral, Gemma, Qwen, directement sur votre ordinateur, sans abonnement, sans envoyer vos données à un serveur tiers et même sans connexion internet une fois le modèle téléchargé. Ce guide vous mène de l'installation à votre première conversation. Comptez environ 15 minutes pour obtenir une IA locale fonctionnelle. Il couvre Ollama 0.40+ sur Windows, macOS et Linux.
Il s'adresse autant aux débutants qu'aux développeurs. Aucune connaissance préalable en intelligence artificielle n'est requise : si vous savez ouvrir un terminal et taper une commande, vous avez le niveau. Ollama est le bon choix quand un assistant en ligne ne convient pas : code sous NDA, données réglementées, budget serré ou travail hors ligne.
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »À la fin de ce guide, vous saurez :
- Installer Ollama sur votre ordinateur (Windows, Mac ou Linux)
- Télécharger et utiliser des modèles d'IA comme Llama, Mistral ou Qwen Coder
- Discuter avec l'IA en ligne de commande
- Choisir le bon modèle selon vos besoins (code, texte, traduction...)
- Savoir où dépanner les erreurs courantes et sécuriser l'accès à Ollama
L'installation et la ligne de commande sont traitées ici de bout en bout. L'intégration Python, le dépannage approfondi et le choix fin d'un modèle font l'objet de guides séparés, référencés au fil du texte.
Qu'est-ce qu'Ollama, explication détaillée
Section intitulée « Qu'est-ce qu'Ollama, explication détaillée »Ollama est un logiciel gratuit et open source (licence MIT) qui télécharge et exécute des grands modèles de langage (LLM) directement sur votre machine, via une simple commande et une API locale sur le port 11434. Il rend l'IA générative utilisable sans abonnement, sans cloud et hors ligne une fois le modèle récupéré.
Avant de plonger dans l'installation, prenons quelques minutes pour comprendre ce qu'est vraiment Ollama et pourquoi il compte. Cette compréhension vous aidera à mieux l'utiliser ensuite.
Le problème que résout Ollama
Section intitulée « Le problème que résout Ollama »Pour utiliser l'IA dans votre travail de développeur, trois voies existent, et aucune n'est gratuite en effort. Elles se distinguent par ce qu'elles coûtent en confidentialité, en argent et en temps de mise en route.
- Un service en ligne (ChatGPT, Claude, Gemini) : très pratique, mais votre code (potentiellement confidentiel) transite par des serveurs tiers, l'usage est payant (abonnement mensuel ou facturation au volume de texte traité) et le service est inutilisable en cas de panne.
- Un modèle installé à la main : techniquement possible, mais il faut télécharger des poids de plusieurs gigaoctets, installer les bonnes versions de Python, PyTorch et CUDA, régler des dizaines de paramètres et écrire le code de chargement. Comptez des heures, même pour un développeur expérimenté.
- Ollama : une seule commande installe un modèle, les paramètres techniques sont réglés automatiquement, une interface simple permet de discuter avec lui et vos données restent locales.
Ollama n'est pas le seul moteur d'inférence local, et il n'est pas toujours le plus adapté. llama.cpp offre un contrôle fin sur la quantization et tourne sur du matériel modeste, vLLM vise le débit sur GPU pour servir plusieurs utilisateurs simultanément, TGI (Text Generation Inference, de Hugging Face) cible le même terrain en production. Ollama gagne sur la simplicité de mise en route et perd sur le réglage fin. Le comparatif des backends d'inférence détaille ces compromis selon votre matériel et votre volume d'usage.
Qu'est-ce qu'un LLM exactement ?
Section intitulée « Qu'est-ce qu'un LLM exactement ? »Vous avez sûrement vu le terme LLM (Large Language Model, grand modèle de langage). Concrètement, c'est un programme informatique entraîné sur d'énormes quantités de texte (livres, articles, code source, pages web...). Grâce à cet entraînement, il a appris :
- Les règles de la langue : grammaire, orthographe, syntaxe
- Les connaissances du monde : histoire, science, actualités (jusqu'à sa date de coupure)
- Les patterns de raisonnement : comment résoudre des problèmes, structurer une réponse
- Les conventions du code : syntaxe des langages, bonnes pratiques, patterns courants
Quand vous posez une question à un LLM, il ne « cherche » pas la réponse dans une base de données. Il génère la réponse mot par mot, en prédisant quel mot est le plus probable après le précédent, compte tenu de votre question et de tout ce qu'il a appris.
Pourquoi "local" change tout
Section intitulée « Pourquoi "local" change tout »Avec un service en ligne, votre question part vers les serveurs du fournisseur (OpenAI, par exemple, aux États-Unis), qui calcule la réponse sur ses GPU puis vous la renvoie. Avec Ollama, le modèle calcule la réponse sur votre propre machine et rien ne sort de votre ordinateur. Le tableau en tire les conséquences concrètes.
| Aspect | ChatGPT (cloud) | Ollama (local) |
|---|---|---|
| Confidentialité | Vos données transitent par des serveurs tiers | Vos données restent sur votre machine |
| Coût | Abonnement ou facturation à l'usage | Gratuit (après achat de l'ordinateur) |
| Internet | Obligatoire | Optionnel (après téléchargement du modèle) |
| Vitesse | Dépend de la latence réseau | Dépend de votre matériel |
| Disponibilité | Peut être saturé ou en maintenance | Toujours disponible |
| Personnalisation | Limitée | Totale (vous pouvez créer vos propres modèles) |
Les cas d'usage concrets
Section intitulée « Les cas d'usage concrets »Quatre scénarios réels montrent où Ollama brille. Dans chacun, c'est la maîtrise des données ou du coût qui fait préférer le local.
- Confidentialité : une développeuse travaille sur un projet client sous NDA (accord de confidentialité). Elle ne peut pas copier son code dans un service en ligne sans violer le contrat ; avec Ollama, il ne quitte pas son poste.
- Budget : un étudiant n'a pas les 20 € par mois d'un abonnement. Ollama lui fournit un assistant gratuit et sans limite de messages pour expliquer des concepts complexes.
- Réseau instable : une consultante qui passe beaucoup de temps dans le train continue de travailler avec l'IA, même dans un tunnel.
- Données réglementées : l'équipe data d'une banque ne peut pas envoyer ses rapports internes chez un fournisseur américain. Ollama permet d'avoir l'IA en interne.
Vérifier que votre ordinateur est compatible
Section intitulée « Vérifier que votre ordinateur est compatible »Avant d'installer Ollama, vérifions que votre machine peut le faire tourner. Rassurez-vous : la plupart des ordinateurs récents (moins de 5-6 ans) sont compatibles.
La RAM : le facteur clé
Section intitulée « La RAM : le facteur clé »La mémoire vive (RAM) est le facteur le plus important. Voici pourquoi :
Quand vous lancez un modèle IA avec Ollama, celui-ci est entièrement chargé en mémoire. Si votre ordinateur n'a pas assez de RAM, le modèle ne pourra pas être chargé, ou sera très lent car il devra utiliser le disque dur (ce qu'on appelle le swap).
| RAM disponible | Modèles utilisables | Expérience |
|---|---|---|
| 4 GB | Très petits modèles (1 à 2 GB) seulement | Possible mais médiocre : lent, qualité limitée |
| 8 GB | Modèles légers (3B) | Fonctionnel mais limité |
| 16 GB | Modèles moyens (7B) | Bonne expérience pour la plupart des usages |
| 32 GB | Grands modèles (13B) | Excellente expérience |
| 64 GB+ | Très grands modèles (70B) | Usage professionnel |
Comment vérifier votre RAM ?
- Windows : clic droit sur la barre des tâches, « Gestionnaire des tâches », onglet « Performances », puis « Mémoire ».
- macOS : menu Pomme, « À propos de ce Mac » ; la RAM est indiquée (par exemple « 16 Go »).
- Linux : la commande ci-dessous affiche la RAM totale.
# Afficher la RAM totalefree -hVous verrez quelque chose comme Mem: 15Gi (pour 16 GB).
L'espace disque
Section intitulée « L'espace disque »Chaque modèle IA occupe de l'espace sur votre disque dur. Voici les tailles typiques :
| Modèle | Taille sur disque |
|---|---|
| Llama 3.2 (3B) | ~2 GB |
| Mistral (7B) | ~4 GB |
| Qwen2.5-Coder (7B) | ~4,7 GB |
| Llama 3.1 (70B) | ~40 GB |
Recommandation : Gardez au moins 20 GB libres pour pouvoir télécharger plusieurs modèles et les essayer.
Le GPU : optionnel mais utile
Section intitulée « Le GPU : optionnel mais utile »Une carte graphique (GPU) n'est pas obligatoire. Ollama fonctionne très bien sur CPU (processeur classique). La différence :
- Sans GPU : Une réponse prend 2-10 secondes
- Avec GPU NVIDIA : Une réponse prend 0.5-2 secondes
Si vous avez un GPU NVIDIA de compute capability 5.0 ou supérieure et un pilote 550 ou plus récent, Ollama l'utilisera automatiquement. Les cartes de compute capability 5.0 à 6.2 demandent un pilote 570 ou plus (documentation officielle d'Ollama, docs/gpu.mdx). La VRAM ne décide pas de l'usage du GPU mais de la taille de modèle qui y tient (environ 8 GB pour un modèle 7B). Sinon, pas de souci, le CPU fera le travail.
Les Mac à puce Apple Silicon (M1 et suivants) constituent un cas à part et particulièrement favorable. Leur mémoire unifiée est partagée entre processeur et GPU intégré : le modèle n'a pas à être recopié dans une VRAM séparée, et un MacBook 16 Go peut charger des modèles qu'un PC portable sans carte graphique dédiée fait ramer. Ollama exploite ce GPU automatiquement, sans pilote ni configuration.
Récapitulatif des prérequis
Section intitulée « Récapitulatif des prérequis »Avant d'installer Ollama, vérifiez que votre machine remplit les prérequis ci-dessous. La RAM est le facteur le plus limitant : c'est elle qui détermine la taille des modèles que vous pourrez charger.
| Composant | Minimum | Recommandé | Idéal |
|---|---|---|---|
| RAM | 8 GB | 16 GB | 32 GB |
| Disque | 20 GB libres | 50 GB libres | 100 GB+ (SSD) |
| Processeur | 64-bit moderne | Multicoeur récent | Apple M1+ ou Intel i7+ |
| GPU | Non requis | NVIDIA 8 GB VRAM | NVIDIA 16 GB+ VRAM |
| Système | Windows 10 22H2, macOS 14 (Sonoma), Linux moderne |
Installation d'Ollama pas à pas
Section intitulée « Installation d'Ollama pas à pas »Maintenant que vous savez que votre machine est compatible, passons à l'installation. Je vais vous guider étape par étape selon votre système d'exploitation.
Installation sur Linux (Ubuntu, Debian, Fedora...)
Section intitulée « Installation sur Linux (Ubuntu, Debian, Fedora...) »Linux est le système le plus simple pour installer Ollama. Trois commandes suffisent : télécharger le script, le relire, puis l'exécuter.
-
Ouvrez un terminal
Utilisez le raccourci
Ctrl + Alt + Tou cherchez "Terminal" dans vos applications. -
Lancez le script d'installation
Copiez-collez cette commande et appuyez sur Entrée :
Fenêtre de terminal # Télécharger le script officiel, l'inspecter, puis l'exécutercurl -fsSL https://ollama.com/install.sh -o ollama-install.shless ollama-install.shsh ollama-install.shQue font ces commandes ?
curl ... -o ollama-install.shtélécharge le script d'installation depuis le site officiel d'Ollama dans un fichierless ollama-install.shvous permet de relire le script avant de l'exécuter (ne jamais lancer à l'aveugle un script distant)sh ollama-install.shexécute le script une fois relu ; il détecte votre distribution Linux et installe Ollama
Le téléchargement et l'installation prennent généralement 1-2 minutes.
-
Vérifiez l'installation
Une fois terminé, vérifiez qu'Ollama est bien installé :
Fenêtre de terminal ollama --versionVous devriez voir quelque chose comme
ollama version is 0.40.4(le numéro peut varier). -
Vérifiez que le service tourne
Ollama s'exécute en tant que service en arrière-plan. Vérifiez son état :
Fenêtre de terminal sudo systemctl status ollamaVous devriez voir
Active: active (running)en vert.
Si quelque chose ne va pas :
# Voir les logs du service pour diagnostiquersudo journalctl -u ollama -f
# Redémarrer le servicesudo systemctl restart ollamaInstallation sur Windows
Section intitulée « Installation sur Windows »Sur Windows, l'installation passe par un installateur graphique classique, sans ligne de commande. Une fois posé, Ollama tourne en service d'arrière-plan signalé par l'icône de lama dans la zone de notification : c'est ce service qui répond aux commandes, et le fermer coupe Ollama.
-
Téléchargez l'installateur
Rendez-vous sur ollama.com/download et cliquez sur le bouton "Download for Windows".
Le fichier
OllamaSetup.exesera téléchargé (environ 200 MB). -
Lancez l'installation
Double-cliquez sur le fichier téléchargé. Si Windows vous demande confirmation ("Voulez-vous autoriser cette application..."), cliquez sur "Oui".
L'assistant d'installation apparaît. Cliquez sur "Install" et attendez quelques instants.
-
Vérifiez l'installation
Ouvrez PowerShell (cherchez "PowerShell" dans le menu Démarrer) et tapez :
Fenêtre de terminal ollama --versionSi vous voyez un numéro de version, l'installation est réussie !
-
Note importante : l'icône dans la barre des tâches
Après l'installation, vous verrez une petite icône Ollama (un lama) dans la zone de notification (en bas à droite). Ollama tourne en arrière-plan, c'est normal et nécessaire pour qu'il fonctionne.
Un dernier point propre à Windows : au premier téléchargement d'un modèle, Windows Defender analyse les fichiers reçus, et un modèle de 2 Go met un moment à être scanné. Le téléchargement paraît alors bloqué alors qu'il ne l'est pas. L'analyse n'a lieu qu'une fois par modèle, les lancements suivants sont immédiats.
Installation sur macOS
Section intitulée « Installation sur macOS »Sur macOS, Ollama se distribue sous forme d'application à glisser dans le dossier Applications. Sur les Mac à puce Apple Silicon (M1 et suivants), le GPU intégré est utilisé automatiquement, ce qui donne des performances souvent supérieures à un PC portable classique sans carte graphique dédiée.
-
Téléchargez l'application
Rendez-vous sur ollama.com/download et cliquez sur "Download for macOS".
Le fichier
Ollama.dmgsera téléchargé. Il demande macOS 14 (Sonoma) ou plus récent ; sur un Mac Intel, Ollama tourne sur le processeur seul, sans accélération GPU. -
Installez l'application
Double-cliquez sur
Ollama.dmgpour monter l'image disque, puis glissez-déposezOllama.appdans votre dossier Applications. Au premier lancement, l'application vérifie que la commandeollamaest accessible dans le terminal et propose de créer le lien dans/usr/local/bin. -
Lancez Ollama
Double-cliquez sur Ollama dans vos Applications. macOS peut vous demander de confirmer ("Ollama est une app téléchargée d'Internet..."), cliquez sur "Ouvrir".
Une icône de lama apparaîtra dans la barre de menu en haut de l'écran.
-
Vérifiez l'installation
Ouvrez le Terminal (Applications → Utilitaires → Terminal) et tapez :
Fenêtre de terminal ollama --versionVous devriez voir le numéro de version s'afficher.
Télécharger votre premier modèle
Section intitulée « Télécharger votre premier modèle »Ollama est installé, mais il lui manque le plus important : un modèle IA. C'est lui qui génère les réponses ; sans modèle chargé, Ollama ne sait rien produire.
Comprendre les modèles disponibles
Section intitulée « Comprendre les modèles disponibles »Ollama donne accès à des dizaines de modèles. Pour commencer, je vous recommande Llama 3.2, développé par Meta (l'entreprise derrière Facebook). Pourquoi ce choix ?
- Éprouvé : sorti en septembre 2024, il est largement documenté et sert d'exemple dans la plupart des guides
- Performant : Excellentes capacités en français et en anglais
- Léger : La version 3B ne pèse que 2 GB
- Polyvalent : Bon pour le texte, le code, la traduction...
Le nom d'un modèle porte deux informations, sa famille et sa taille : dans « Llama 3.2 3B », le « 3B » signifie 3 milliards de paramètres. Les paramètres sont les poids ajustables du réseau de neurones, chacun étant un nombre appris pendant l'entraînement. Plus il y en a, plus le modèle capture de régularités du langage, et plus il consomme de mémoire et de calcul. Un modèle plus petit n'est donc pas « moins bon » dans l'absolu, il est plus rapide et moins précis sur les tâches de raisonnement. Pour un usage personnel, 3B est un excellent compromis.
| Taille du modèle | RAM minimale | Usage typique |
|---|---|---|
| 1-3B | 4 GB (1-2B) à 8 GB (3B) | Questions simples, résumés, traduction |
| 7B | 8-16 GB | Code, rédaction, raisonnement |
| 13B | 16-32 GB | Analyse complexe, créativité |
| 70B | 64 GB+ | Recherche, usage professionnel |
Si vous disposez d'un GPU, la règle de dimensionnement change : c'est la VRAM (la mémoire de la carte graphique) qui décide, et non la RAM système. En quantization Q4_K_M, le format par défaut des modèles distribués par Ollama, prévoyez à peu près autant de VRAM que la taille du fichier téléchargé, plus 1 à 2 Go pour le contexte. Concrètement, 8 Go de VRAM font tourner un modèle 7B ou 8B (Llama 3.1 8B, Qwen3 8B), 16 Go un modèle 13B-14B, 24 Go et plus un modèle 32B. Sans GPU, restez sur du 1B-3B, sinon la génération devient pénible.
Le point à retenir est le seuil : dès que le modèle déborde de la VRAM vers la RAM système, la vitesse chute de 2 à 10 fois. Mieux vaut un modèle plus petit qui tient entièrement en VRAM qu'un modèle ambitieux qui déborde. Le détail par cas d'usage et par niveau de quantization est traité dans le guide quel modèle choisir en 2026.
Télécharger Llama 3.2
Section intitulée « Télécharger Llama 3.2 »Ouvrez votre terminal (ou PowerShell sur Windows) et tapez :
ollama pull llama3.2Que se passe-t-il exactement ?
- Ollama contacte son registre (une sorte de "magasin" de modèles)
- Il télécharge le modèle morceau par morceau (vous verrez une barre de progression)
- Il vérifie l'intégrité des fichiers téléchargés (pour s'assurer qu'ils ne sont pas corrompus)
- Il enregistre le modèle dans le stockage local d'Ollama
Le téléchargement prend généralement 2 à 10 minutes selon votre connexion internet. Vous verrez quelque chose comme :
pulling manifestpulling dde5aa3fc5ff... 50% ▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░ 1.1 GB/2.0 GB 45 MB/sLa commande est rejouable sans risque : si le modèle est déjà présent, ollama pull llama3.2 se contente de vérifier les couches et se termine en quelques secondes. C'est aussi la commande qui met à jour un modèle quand une nouvelle version est publiée sur le registre.
Vérifier que le téléchargement a fonctionné
Section intitulée « Vérifier que le téléchargement a fonctionné »Une fois le téléchargement terminé, vérifiez que le modèle est bien installé :
ollama listVous devriez voir :
NAME ID SIZE MODIFIEDllama3.2:latest a80c4f17acd5 2.0 GB About a minute agoBravo ! Vous avez maintenant une IA locale prête à l'emploi.
Votre première conversation avec l'IA
Section intitulée « Votre première conversation avec l'IA »C'est le moment tant attendu : parler avec votre IA locale.
Lancer une session interactive
Section intitulée « Lancer une session interactive »Tapez cette commande :
ollama run llama3.2Après quelques secondes de chargement, vous verrez apparaître une invite de commande :
>>>C'est ici que vous allez taper vos questions. Le modèle attend votre message !
Exemple de conversation complète
Section intitulée « Exemple de conversation complète »Voici un exemple de ce que vous pouvez faire. Tapez exactement ce qui suit le >>> :
Vous :
>>> Bonjour ! Peux-tu te présenter ?L'IA répond :
Bonjour ! Je suis un assistant IA basé sur le modèle Llama 3.2, développé parMeta. Je suis conçu pour vous aider dans diverses tâches comme répondre à vosquestions, générer du texte, traduire, expliquer des concepts, et bien plusencore.
Je fonctionne entièrement sur votre ordinateur grâce à Ollama, ce qui signifieque vos conversations restent privées et ne sont envoyées nulle part.
Comment puis-je vous aider aujourd'hui ?Vous :
>>> Explique-moi ce qu'est Docker comme si j'avais 10 ansL'IA répond :
Imagine que tu veux jouer à un jeu vidéo chez ton ami. Mais le jeu a besoin deplein de choses sur l'ordinateur : des fichiers spéciaux, des réglagesparticuliers... Si ton ami n'a pas exactement les mêmes choses, le jeu nemarchera pas !
Docker, c'est comme une boîte magique où tu mets ton jeu avec TOUT ce dont il abesoin. Quand tu donnes cette boîte à ton ami, il peut ouvrir la boîte et le jeumarche tout de suite, même si son ordinateur est différent du tien.
Les développeurs utilisent Docker pour mettre leurs programmes dans des "boîtes"(on appelle ça des "conteneurs"). Comme ça, le programme marche pareil partout,sur n'importe quel ordinateur !Vous :
>>> Super ! Maintenant, écris-moi une fonction Python qui compte les mots dans une phraseL'IA répond :
def compter_mots(phrase): """ Compte le nombre de mots dans une phrase.
Args: phrase (str): La phrase à analyser
Returns: int: Le nombre de mots """ # Supprimer les espaces au début et à la fin phrase = phrase.strip()
# Si la phrase est vide, retourner 0 if not phrase: return 0
# Séparer la phrase en mots et compter mots = phrase.split() return len(mots)
# Exemple d'utilisationtexte = "Bonjour, comment allez-vous aujourd'hui ?"nombre = compter_mots(texte)print(f"La phrase contient {nombre} mots.")Quitter la session
Section intitulée « Quitter la session »Pour terminer la conversation, tapez :
>>> /byeVous reviendrez à votre terminal normal.
Astuces pour de meilleures réponses
Section intitulée « Astuces pour de meilleures réponses »L'IA fonctionne mieux quand vous lui donnez des instructions claires et détaillées. Voici quelques techniques :
Question vague, à éviter :
>>> Parle-moi de PythonQuestion précise :
>>> Explique les différences entre les listes et les tuples en Python, avec des exemples de cas où utiliser l'un plutôt que l'autreDemande générique, à éviter :
>>> Écris du codeDemande contextualisée :
>>> Écris une fonction Python qui prend une liste de nombres et retourne la moyenne, en gérant le cas où la liste est vide. Ajoute des commentaires explicatifs.Commandes Ollama essentielles
Section intitulée « Commandes Ollama essentielles »Maintenant que vous savez discuter avec l'IA, voici les commandes indispensables à connaître.
Gérer vos modèles
Section intitulée « Gérer vos modèles »Quatre commandes couvrent tout le cycle de vie d'un modèle : le lister, le
télécharger, le supprimer et l'inspecter. La plus utile au quotidien est
ollama rm : les modèles s'accumulent vite et un modèle 70B occupe une
quarantaine de gigaoctets, autant faire le ménage des modèles que vous ne
testez plus, pour libérer de l'espace disque.
# Lister tous les modèles installés sur votre machineollama list
# Télécharger un nouveau modèle (exemple : Mistral)ollama pull mistral
# Supprimer un modèle pour libérer de l'espace disqueollama rm mistral
# Voir les détails d'un modèle (taille, paramètres, licence...)ollama show llama3.2Lancer des commandes ponctuelles
Section intitulée « Lancer des commandes ponctuelles »Vous n'êtes pas obligé d'ouvrir une session interactive. Vous pouvez poser une question unique :
# Poser une question et obtenir la réponse immédiatementollama run llama3.2 "Quelle est la capitale de l'Australie ?"La réponse s'affiche, puis vous revenez au terminal. C'est pratique pour des questions rapides ou pour intégrer Ollama dans des scripts.
Utiliser plusieurs modèles
Section intitulée « Utiliser plusieurs modèles »Vous pouvez installer plusieurs modèles et basculer entre eux :
# Installer plusieurs modèlesollama pull llama3.2ollama pull mistralollama pull qwen2.5-coder:7b
# Utiliser Mistral pour cette questionollama run mistral "Écris un haïku sur l'automne"
# Utiliser Qwen2.5-Coder pour du codeollama run qwen2.5-coder:7b "Écris une regex pour valider une adresse email"Chaque modèle occupe de l'espace disque, il ne sert donc à rien de tous les installer d'emblée. Le tableau ci-dessous donne le point fort de chacun et la commande pour l'obtenir : choisissez selon ce que vous faites le plus souvent, quitte à en supprimer un plus tard avec ollama rm.
| Modèle | Taille | Point fort | Commande |
|---|---|---|---|
| llama3.2 | 2 GB | Polyvalent, bon en français | ollama pull llama3.2 |
| mistral | 4 GB | Raisonnement, logique | ollama pull mistral |
| qwen2.5-coder:7b | 4,7 GB | Génération de code | ollama pull qwen2.5-coder:7b |
| gemma:2b | 1,7 GB | Léger et rapide, pour machine modeste | ollama pull gemma:2b |
Pour débuter, llama3.2 suffit largement. Ajoutez qwen2.5-coder:7b si vous faites beaucoup de développement (pour le choix fin, voir le comparatif des modèles 2026), et gemma:2b si votre machine est modeste.
Utiliser Ollama avec Python
Section intitulée « Utiliser Ollama avec Python »Ollama s'appelle aussi depuis vos scripts Python, via l'API REST sur le port 11434, le SDK natif ollama, litellm ou le client OpenAI pointé sur votre instance locale. Le guide Ollama avancé : SDK Python, Structured Output et embeddings vérifie l'API REST, puis déroule le SDK natif et le client OpenAI avant de construire un assistant complet.
Trois besoins reviennent ensuite systématiquement dès qu'on branche un LLM local sur du code, et chacun a son guide.
- Obtenir une réponse exploitable par un programme, c'est-à-dire un JSON conforme à un schéma plutôt qu'un paragraphe : sorties structurées avec Ollama.
- Laisser le modèle appeler vos propres fonctions (interroger une base, lancer une commande) au lieu de décrire ce qu'il ferait : tool calling avec Ollama.
- Faire analyser des images par un modèle multimodal, capture d'écran ou schéma : modèles de vision avec Ollama.
Dépannage et configuration
Section intitulée « Dépannage et configuration »Les erreurs courantes (Ollama ne répond pas, modèle introuvable, lenteur) et la configuration (emplacement de stockage, limites mémoire, exposition réseau et sécurité du port 11434, piège du contexte) sont regroupées dans un guide dédié : Ollama : dépannage et configuration.
Checklist
Section intitulée « Checklist »Parcourez ces points dans l'ordre pour valider que votre installation est complète et opérationnelle. Les deux premiers blocs sont indispensables ; le troisième relève du confort et peut attendre.
Installation
Section intitulée « Installation »Ces quatre points valident qu'Ollama est bien posé et que son service tourne réellement sur votre machine.
- RAM vérifiée (8 GB minimum, 16 GB recommandé)
- Espace disque disponible (20 GB minimum)
- Ollama installé (
ollama --versionfonctionne) - Service Ollama actif (icône visible ou
systemctl status ollama)
Premier modèle
Section intitulée « Premier modèle »Un modèle téléchargé et une première réponse obtenue prouvent que toute la chaîne, du registre au terminal, fonctionne.
- Modèle téléchargé (
ollama pull llama3.2) - Session interactive testée (
ollama run llama3.2) - Question test posée et réponse obtenue
Utilisation avancée (optionnel)
Section intitulée « Utilisation avancée (optionnel) »Ces points ne sont pas indispensables pour discuter avec l'IA, ils préparent l'intégration d'Ollama dans vos scripts et vos projets Python.
- Plusieurs modèles installés (llama3.2, qwen2.5-coder:7b, mistral...)
- Je sais où trouver l'intégration Python si besoin
À retenir
Section intitulée « À retenir »- Ollama = LLM local : exécutez des modèles IA comme Llama, Mistral ou Qwen Coder directement sur votre machine, sans envoyer vos données à des serveurs tiers.
- Deux commandes suffisent :
ollama pull llama3.2télécharge le modèle,ollama run llama3.2lance la conversation. Pas de configuration complexe. - La RAM est le facteur clé : 8 GB minimum pour les petits modèles (3B), 16 GB recommandés pour les modèles moyens (7B), 32 GB pour les grands (13B+).
- Gratuit et illimité : pas d'abonnement, pas de limite de messages, pas de file d'attente.
- Fonctionne hors ligne : une fois le modèle téléchargé, plus besoin d'internet. Idéal pour la confidentialité ou les déplacements.
- API locale : l'API REST sur le port 11434 permet d'appeler le modèle depuis vos scripts Python, sans l'exposer sur le réseau.
Contrôle de connaissances
Section intitulée « Contrôle de connaissances »Vérifiez que l'essentiel de ce guide est acquis. Les questions portent uniquement sur ce qui vient d'être expliqué ici.
Contrôle de connaissances
Validez vos connaissances avec ce quiz interactif
Informations
- Le chronomètre démarre au clic sur Démarrer
- Questions à choix multiples, vrai/faux et réponses courtes
- Vous pouvez naviguer entre les questions
- Les résultats détaillés sont affichés à la fin
Lance le quiz et démarre le chronomètre
Vérification
(0/0)Score par domaine
Un domaine regroupe plusieurs guides et reçoit plusieurs questions : son score est plus fiable qu'un score par thème, qui porte souvent sur une seule question.
Bilan
Points forts
Aucun sujet réussi à 80 % sur au moins deux questions pour l’instant.
Points faibles
Aucun sujet sous le seuil de réussite.
À faire ensuite
Des indices pour retenter votre chance ?
Continuer le cours : Ollama : dépannage et configuration
Nouveau quiz complet avec des questions aléatoires
Retravailler uniquement les questions ratées
Retour à la liste des certifications
Questions fréquentes
Section intitulée « Questions fréquentes »Caractéristiques clés
| Avantage | Description |
|---|---|
| Gratuit | Aucun coût d'utilisation, hors matériel et électricité |
| Privé | Vos questions et vos données restent sur votre machine |
| Hors ligne | Fonctionne sans connexion une fois le modèle téléchargé |
| Simple | Une commande pour télécharger un modèle, une pour l'utiliser |
Premier essai
Une fois Ollama installé (installateur graphique sur Windows et macOS, script ou archive sur Linux), deux commandes suffisent :ollama pull llama3.2
ollama run llama3.2
Cas d'usage
- Développement : génération de code, aide au débogage
- Rédaction : traduction, résumés, reformulation
- Apprentissage : expérimenter avec l'IA sans frais
- Entreprise : traitement de données sensibles en local
Comparaison
| Aspect | Ollama | ChatGPT |
|---|---|---|
| Exécution | Sur votre PC (local) | Serveurs OpenAI (cloud) |
| Coût | Gratuit, hors matériel et électricité | Offre gratuite limitée, abonnements payants, API facturée à l'usage |
| Confidentialité | Les données restent locales | Les données transitent par OpenAI |
| Internet | Non requis après téléchargement du modèle | Obligatoire |
| Performance | Dépend de votre matériel | Constante, serveurs dédiés |
| Modèles | Modèles ouverts : Llama, Mistral, Gemma, Qwen... | Modèles propriétaires d'OpenAI |
Quand choisir Ollama ?
- Traitement de données confidentielles (code propriétaire, documents internes)
- Budget limité ou usage intensif, sans quota de messages
- Besoin de fonctionner hors ligne
- Expérimentation et apprentissage
Quand choisir ChatGPT ?
- Besoin de la meilleure qualité de réponse sur des tâches difficiles
- Machine trop modeste pour un modèle local (moins de 8 GB de RAM)
- Besoin des fonctions intégrées du service (recherche web, analyse de fichiers)
Comment ça marche ?
Le modèle ne cherche pas la réponse dans une base de données : il la produit mot par mot, en prédisant la suite la plus probable compte tenu de votre question et de ce qu'il a appris pendant son entraînement (livres, articles, code, pages web).Que veut dire 3B, 8B ou 70B ?
Le chiffre indique le nombre de paramètres, en milliards : ce sont les valeurs apprises pendant l'entraînement. Plus il y en a, plus le modèle est capable, et plus il consomme de mémoire.| Taille | RAM conseillée | Exemple |
|---|---|---|
| 1 à 3B | 8 GB | llama3.2 (3B) |
| 7 à 8B | 16 GB | llama3.1:8b, qwen3 |
| 13 à 14B | 32 GB | modèles de taille moyenne |
| 70B | 64 GB+ | llama3.3 |
Quelques familles de modèles ouverts
- Llama (Meta) : polyvalent, très répandu
- Qwen (Alibaba) : polyvalent, bon en code et en appels d'outils
- Mistral (Mistral AI) : société française, bon en français
- Gemma (Google) : léger, existe en version multimodale
Configuration minimale et recommandée
| Composant | Minimum | Recommandé | Idéal |
|---|---|---|---|
| RAM | 8 GB | 16 GB | 32 GB+ |
| Stockage | 20 GB libres | 50 GB libres | 100 GB+ (SSD) |
| GPU | Non requis | NVIDIA 8 GB de VRAM | NVIDIA 16 GB+ de VRAM |
| Système | Windows 10 22H2, macOS 14, Linux 64 bits |
Quel modèle pour quelle RAM ?
| RAM disponible | Exemples de modèles |
|---|---|
| 8 GB | llama3.2 (3B), gemma:2b |
| 16 GB | llama3.1:8b, mistral (7B) |
| 32 GB | modèles de 13B à 14B, mixtral en quantization forte |
| 64 GB+ | llama3.1:70b |
llama3.1:13b.Un GPU est-il obligatoire ?
Non. Les modèles tournent sur le processeur, ils sont seulement plus lents. Avec une carte NVIDIA, c'est la VRAM qui décide de la taille du modèle : un modèle qui déborde de la VRAM vers la RAM ralentit fortement. Sur un Mac Apple Silicon, le GPU intégré est utilisé automatiquement ; un Mac Intel tourne sur le processeur seul.Vérifier vos ressources
# Linux : mémoire disponible
free -h
# Carte NVIDIA : modèle et VRAM
nvidia-smi
# macOS : mémoire installée
system_profiler SPHardwareDataType | grep Memory
Choisir selon l'usage
| Votre besoin | Modèle | Commande |
|---|---|---|
| Découvrir Ollama | Llama 3.2 (3B) | ollama pull llama3.2 |
| Usage général, plus de qualité | Qwen3 (8B) | ollama pull qwen3 |
| Programmation | Qwen2.5-Coder (7B) | ollama pull qwen2.5-coder:7b |
| Machine très modeste | Gemma 2B | ollama pull gemma:2b |
| Embeddings pour un RAG | nomic-embed-text | ollama pull nomic-embed-text |
Comparer sur votre machine
ollama pull llama3.2
ollama pull qwen3
ollama run llama3.2 "Explique Docker en 3 phrases"
ollama run qwen3 "Explique Docker en 3 phrases"
Posez la même question aux deux modèles : la qualité et la vitesse se jugent sur vos propres demandes, pas sur un classement. Le guide quel modèle choisir en 2026 détaille les choix par usage, par mémoire GPU et par licence.curl ... | sh.Installation par le script officiel
curl -fsSL https://ollama.com/install.sh -o ollama-install.sh
less ollama-install.sh
sh ollama-install.sh
Le script détecte votre distribution, installe le binaire et crée un service systemd ollama, qui tourne sous un compte système dédié.Installation manuelle, sans script
La documentation officielle décrit aussi une installation par archive : décompressezollama-linux-amd64.tar.zst (ou la variante arm64) dans /usr, puis créez vous-même le compte ollama et le fichier /etc/systemd/system/ollama.service. Cette voie convient quand la politique de sécurité interdit d'exécuter un script d'installation.Vérifier l'installation
ollama --version
sudo systemctl status ollama
ollama run llama3.2 "Bonjour !"
Où sont les fichiers ?
- Modèles du service :
/usr/share/ollama/.ollama/models - Service :
/etc/systemd/system/ollama.service - Journaux :
journalctl -u ollama -f
Avec un GPU NVIDIA
Installez d'abord le pilote NVIDIA et vérifiez-le avecnvidia-smi : Ollama détecte ensuite le GPU automatiquement, sans réglage.Installation
- Téléchargez l'installateur depuis ollama.com/download
- Double-cliquez sur
OllamaSetup.exeet suivez l'assistant - Une icône de lama apparaît dans la zone de notification : Ollama tourne en arrière-plan
Vérifier l'installation
ollama --version
ollama run llama3.2 "Bonjour !"
Où sont les fichiers ?
- Modèles et configuration :
%HOMEPATH%\.ollama - Binaires :
%LOCALAPPDATA%\Programs\Ollama(ajouté au PATH de l'utilisateur) - Journaux :
%LOCALAPPDATA%\Ollama
OLLAMA_MODELS dans votre compte utilisateur.Prérequis
| Élément | Requis |
|---|---|
| Windows | 10 22H2 ou plus récent, Home ou Pro |
| RAM | 8 GB minimum |
| WSL2 | Non requis |
| GPU NVIDIA | Facultatif, pilote à jour (vérifiez avec nvidia-smi) |
Installation
- Téléchargez
Ollama.dmgdepuis ollama.com/download - Double-cliquez dessus pour monter l'image disque
- Glissez
Ollama.appdans le dossier Applications, puis lancez-la - Au premier lancement, l'application propose de créer le lien de la commande
ollamadans/usr/local/bin
Vérifier l'installation
ollama --version
ollama run llama3.2 "Bonjour !"
Apple Silicon ou Intel ?
| Processeur | Accélération |
|---|---|
| Apple M1 et suivants | Processeur et GPU intégré, via Metal, sans configuration |
| Intel (x86) | Processeur seul |
Où sont les fichiers ?
- Modèles :
~/.ollama/models - Application :
/Applications/Ollama.app - Journaux :
~/.ollama/logs/
Diagnostic rapide
# Linux : mémoire libre
free -h
# Modèles chargés et mémoire qu'ils occupent
ollama ps
Solution 1 : un modèle plus petit
C'est la solution la plus simple. Un modèle 70B demande de l'ordre de 64 GB de RAM ;llama3.2 (3B) tourne avec 8 GB, et gemma:2b est encore plus léger.ollama run llama3.2
ollama run gemma:2b
Solution 2 : libérer de la mémoire
Fermez les applications gourmandes (navigateur chargé, IDE, machines virtuelles) et déchargez les modèles inutiles :ollama ps les liste, ollama stop <modèle> libère la mémoire de l'un d'eux.Solution 3 : un seul modèle à la fois
La variableOLLAMA_MAX_LOADED_MODELS=1 empêche Ollama de garder plusieurs modèles en mémoire. Sur Linux, elle se pose dans le service avec sudo systemctl edit ollama, puis sudo systemctl restart ollama.Solution 4 : le swap, en dernier recours
Ajouter du swap évite l'erreur mais rend la génération très lente : préférez toujours un modèle plus petit. Le guide Ollama : dépannage et configuration détaille les réglages mémoire.Diagnostic
# Le serveur répond-il ?
curl http://localhost:11434/api/version
# Linux : état du service
sudo systemctl status ollama
Solution 1 : démarrer le service
# Linux (systemd)
sudo systemctl start ollama
sudo systemctl enable ollama # démarrage automatique
Sur Windows et macOS, lancez l'application Ollama : l'icône de lama doit apparaître dans la zone de notification ou la barre de menu.Solution 2 : lire les journaux
sudo journalctl -u ollama -n 50
Trois messages reviennent souvent : address already in use (port déjà pris), permission denied (droits sur le dossier des modèles), et une erreur de pilote GPU.Solution 3 : port déjà occupé
sudo ss -tlnp | grep 11434
Si une autre instance occupe le port (souvent un ollama serve lancé à la main en plus du service), arrêtez-la. Pour changer de port, définissez OLLAMA_HOST=127.0.0.1:<port> pour le serveur et pour le client.Solution 4 : réinstaller sans perdre les modèles
Relancez simplement l'installation : elle remplace le binaire sans toucher aux modèles téléchargés. Ne supprimez pas le dossier des modèles, sauf pour récupérer de la place. Le guide Ollama : dépannage et configuration couvre les autres causes.Diagnostic
ollama list
La colonne NAME donne le nom exact de chaque modèle installé, avec son étiquette : llama3.2:latest, mistral:latest. Sans étiquette, Ollama ajoute :latest de lui-même.Solution 1 : vérifier le nom exact
Les noms sont en minuscules et suivent la bibliothèque officielle :ollama run llama3.2 # correct
ollama run llama-3.2 # incorrect : tiret au lieu du point
ollama run Llama3.2 # incorrect : majuscule
Solution 2 : télécharger le modèle
ollama pull llama3.2
ollama pull llama3.1:8b # une taille précise, par son étiquette
Solution 3 : trouver le bon nom
La bibliothèque ollama.com/library liste chaque modèle avec ses étiquettes disponibles (tailles, quantizations). Copiez le nom depuis la page du modèle plutôt que de le deviner.Solution 4 : modèle corrompu
ollama rm llama3.2
ollama pull llama3.2
ollama show llama3.2
Diagnostic
# Le registre est-il joignable ?
curl -I https://registry.ollama.ai
# Reste-t-il de la place ? (Linux, service systemd)
df -h /usr/share/ollama
Derrière un proxy d'entreprise
C'est le serveur Ollama qui télécharge, pas votre terminal : une variable exportée dans votre shell ne l'atteint pas. Selon la documentation officielle, posezHTTPS_PROXY sur le service, et n'utilisez pas HTTP_PROXY, qui peut couper les connexions des clients au serveur. Sous Linux :sudo systemctl edit ollama.service
# Ajouter :
# [Service]
# Environment="HTTPS_PROXY=https://proxy.entreprise.lan:3128"
sudo systemctl restart ollama
Si le proxy inspecte le TLS, installez son certificat d'autorité comme certificat système. Ne contournez jamais l'erreur en désactivant la vérification des certificats.Téléchargement interrompu
Relancez simplementollama pull <modèle> : les couches déjà reçues sont conservées et le téléchargement reprend où il s'était arrêté.Espace disque
Listez les modèles avecollama list et supprimez ceux qui ne servent plus avec ollama rm <modèle> : c'est la seule façon propre de libérer de la place, sans toucher aux fichiers à la main. Pour déplacer le stockage, voir la question « Où sont stockés les modèles Ollama ? » et le guide Ollama : dépannage et configuration.address already in use signifie qu'un processus l'occupe déjà, et c'est presque toujours Ollama lui-même.Diagnostic
sudo ss -ltnp | grep 11434
Le sudo fait apparaître le nom et le PID du processus.Cas le plus fréquent : un ollama serve en trop
Sous Linux, le service systemd installé par le script officiel occupe déjà le port. Lancer ollama serve à la main crée une seconde instance, qui échoue. Ne lancez pas ollama serve : utilisez le service, avec sudo systemctl status ollama pour l'état et sudo systemctl restart ollama pour le redémarrer.Changer de port
Le port se change sur le service, pas dans votre shell :sudo systemctl edit ollama.service
# Ajouter :
# [Service]
# Environment="OLLAMA_HOST=127.0.0.1:11435"
sudo systemctl restart ollama
Les clients doivent alors viser ce port, par exemple avec OLLAMA_HOST=127.0.0.1:11435 ollama list ou Client(host="http://127.0.0.1:11435") en Python. Gardez l'adresse 127.0.0.1 : 0.0.0.0 exposerait une API sans authentification à tout le réseau. Le guide Ollama : dépannage et configuration détaille ces réglages.Prérequis
- Un GPU NVIDIA de compute capability 5.0 ou plus
- Le pilote NVIDIA 550 ou plus récent ; les cartes de compute capability 5.0 à 6.2 demandent le pilote 570 ou plus
- Le CUDA Toolkit n'est pas nécessaire : Ollama embarque ses propres bibliothèques
nvidia-smi, en haut à droite de sa sortie (Driver Version).Ollama utilise-t-il vraiment le GPU ?
Lancez une requête pour charger le modèle, puis :ollama ps
La colonne PROCESSOR répond : 100% GPU (entièrement sur la carte), 100% CPU, ou un partage comme 48%/52% CPU/GPU, nettement plus lent. C'est la vérification fiable ; nvidia-smi montre en complément la mémoire occupée sur la carte.Installer le pilote
Passez par l'outil de votre distribution, qui choisit un pilote compatible avec votre carte :sudo ubuntu-drivers install sur Ubuntu, le dépôt RPM Fusion (akmod-nvidia) sur Fedora. Redémarrez ensuite.Forcer l'usage du processeur
Pour ignorer le GPU, la documentation officielle prescritCUDA_VISIBLE_DEVICES=-1, posée sur le service avec sudo systemctl edit ollama.service (Environment="CUDA_VISIBLE_DEVICES=-1"), puis un redémarrage. Si le GPU n'est jamais détecté, OLLAMA_DEBUG=1 ajoute des détails dans les journaux. Voir le guide Ollama : dépannage et configuration.Points d'accès principaux
| Endpoint | Méthode | Rôle |
|---|---|---|
/api/generate |
POST | Générer un texte à partir d'un prompt |
/api/chat |
POST | Conversation avec historique de messages |
/api/embed |
POST | Calculer des embeddings (vecteurs) |
/api/tags |
GET | Lister les modèles installés |
/api/show |
POST | Détails d'un modèle |
/api/pull |
POST | Télécharger un modèle |
/api/embeddings est remplacé par /api/embed dans la documentation officielle.Exemples
# Génération simple
curl http://localhost:11434/api/generate -d '{
"model": "llama3.2",
"prompt": "Explique Docker en 2 phrases",
"stream": false
}'
# Embeddings, avec un modèle dédié
curl http://localhost:11434/api/embed -d '{
"model": "nomic-embed-text",
"input": "Docker est une plateforme de conteneurisation"
}'
Sans "stream": false, la réponse arrive en flux : une ligne JSON par fragment.Depuis Python
Le SDKollama évite d'écrire les requêtes HTTP à la main et donne accès aux sorties structurées : le guide Ollama avancé : SDK Python, Structured Output et embeddings le déroule pas à pas, client OpenAI compris.Emplacements par défaut
| Cas | Emplacement |
|---|---|
| Linux, service systemd (script officiel) | /usr/share/ollama/.ollama/models |
Linux, ollama serve lancé à la main |
~/.ollama/models |
| macOS | ~/.ollama/models |
| Windows | C:\Users\%username%\.ollama\models |
ollama, dont le répertoire personnel est /usr/share/ollama. Un ollama serve lancé sous votre compte ne voit donc pas les modèles du service, ce qui explique certains model not found.Ce que contient le dossier
manifests/: la description de chaque modèle et de ses étiquettesblobs/: les couches binaires, nommées par leur empreintesha256
Déplacer le stockage
Posez la variableOLLAMA_MODELS sur le service, jamais avec export dans votre shell :sudo systemctl edit ollama.service
# Ajouter :
# [Service]
# Environment="OLLAMA_MODELS=/srv/ollama/models"
sudo systemctl restart ollama
Le nouveau dossier doit être accessible en lecture et en écriture à l'utilisateur ollama (ls -ld pour le vérifier). Sous Windows, définissez OLLAMA_MODELS dans les variables d'environnement de votre compte. Les détails sont dans le guide Ollama : dépannage et configuration.Gratuit et open source (MIT)
Ollama est gratuit et open source sous licence MIT. Il n'y a ni abonnement, ni quota de messages, ni édition payante : vous téléchargez le logiciel et les modèles, puis vous les exécutez sans frais.| Poste | Ollama (local) | Service cloud (ChatGPT Plus) |
|---|---|---|
| Licence logicielle | Gratuite (MIT) | Abonnement 20 $/mois |
| Coût par requête | 0 € | Facturé ou plafonné |
| Vrai coût | Matériel + électricité | Abonnement récurrent |
ollama show <modèle> affiche.Deux approches du LLM local
Ollama et LM Studio exécutent tous deux des modèles en local, mais ne visent pas le même usage.| Critère | Ollama | LM Studio |
|---|---|---|
| Interface | Ligne de commande + API REST | Application graphique |
| Automatisation | Native (ollama run, port 11434) |
Serveur local optionnel |
| Public | Développeurs, serveurs, scripts | Découverte, usage bureautique |
| Licence | Open source (MIT) | Gratuit, propriétaire |
Ressources officielles
Section intitulée « Ressources officielles »Ces quatre sources font référence quand une commande ou une option de ce guide évolue : la documentation de l'API décrit les points d'accès du port 11434, le catalogue donne les étiquettes exactes de chaque modèle, et le dépôt GitHub porte les notes de version.
- Site web Ollama : ollama.com
- Code source sur GitHub : github.com/ollama/ollama
- Catalogue de modèles : ollama.com/library
- Documentation de l'API : docs.ollama.com/api