Je viens de passer une bonne heure à m’arracher les cheveux sur mon PC portable en essayant de lancer un LLM en local. Je tape fièrement ollama run llama3 dans mon terminal, et là, le fameux message d’erreur qui coupe direct dans l’élan : “ollama n’est pas reconnu en tant que commande interne ou externe, un programme exécutable ou un fichier de commandes”.
Honnêtement, au début, j’ai cru que l’installation avait complètement foiré. Mais en fait, c’est juste un grand classique de Windows.
Pour faire simple, Windows fonctionne avec une liste de courses géante qu’on appelle la variable d’environnement PATH. Quand on tape une commande, il parcourt cette liste pour trouver où est caché l’exécutable. Si le dossier n’est pas dans la liste, il abandonne direct. Comme Ollama s’installe par défaut dans le dossier caché AppData (pour pouvoir s’exécuter et se mettre à jour sans réclamer les droits d’administrateur à chaque fois), Windows s’emmêle souvent les pinceaux et oublie de l’ajouter à sa liste.
Si vous êtes bloqués là-dessus, voici les étapes exactes qui m’ont sauvé la mise.
Étape 1 : Récupérer le chemin d’Ollama
- Appuyez sur les touches Windows + R pour ouvrir la fenêtre “Exécuter”.
- Tapez
%localappdata%\Programs\Ollamaet validez. - Une fenêtre de l’explorateur s’ouvre (c’est là que se cache ce cher
ollama.exe). Cliquez sur la barre d’adresse tout en haut, faites un clic droit et copiez le chemin. Ça devrait ressembler à un truc du genre :C:\Users\VotreNom\AppData\Local\Programs\Ollama.
Étape 2 : Mettre à jour la variable PATH
- Appuyez sur la touche Windows, tapez env et cliquez sur Modifier les variables d’environnement système.
- Dans la petite fenêtre qui s’ouvre, cliquez sur le bouton Variables d’environnement… en bas à droite.
- Dans la section du haut (“Variables utilisateur pour [VotreNom]”), cherchez la ligne qui s’appelle Path (ou PATH), sélectionnez-la et cliquez sur Modifier….
- Cliquez sur le bouton Nouveau à droite, puis collez le chemin que vous avez copié à l’étape 1.
- Cliquez sur OK sur toutes les fenêtres pour bien enregistrer les modifications.
Étape 3 : Le piège du terminal (à ne pas louper !)
C’est là que j’ai perdu 15 minutes pour rien : il faut absolument fermer et rouvrir votre terminal (Invite de commandes ou PowerShell) pour que les changements soient pris en compte.
Si (comme moi) vous utilisez le terminal intégré de VS Code, sachez qu’il est particulièrement têtu. Il refuse souvent de mettre à jour le PATH à chaud. Il faut fermer complètement toutes les fenêtres de VS Code et relancer l’application.
Une fois votre nouveau terminal ouvert, tapez :ollama --version
Si le numéro de version s’affiche, c’est gagné !
Quelques astuces bonus si ça coince encore :
- La méthode feignante (si vous voulez tout réinstaller proprement) : Windows possède un gestionnaire de paquets natif. Vous pouvez ouvrir un terminal et taper
winget install ollama. L’avantage, c’est que winget gère la configuration du PATH automatiquement à l’installation. - Pour tester sans modifier le PATH (en direct) : Vous pouvez lancer Ollama en lui indiquant le chemin absolu entre guillemets. Par exemple :
"C:\Users\VotreNom\AppData\Local\Programs\Ollama\ollama.exe" run llama3 - Si PowerShell fait de la résistance : Parfois, PowerShell garde en cache les vieilles variables. Pour le forcer à se rafraîchir les idées sans redémarrer le PC, vous pouvez coller cette ligne dans votre session :
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")
Autre galère fréquente : “ollama serve” ne fonctionne pas
Une fois le PATH réparé, j’ai voulu lancer le serveur manuellement en tapant ollama serve, et boum, nouvelle erreur ou crash instantané.
En fait, par défaut, Ollama se lance tout seul en arrière-plan dès le démarrage de Windows. Comme il ne peut y avoir qu’une seule instance à la fois sur le port 11434, la commande manuelle plante.
- La solution simple : Regardez dans votre barre des tâches (en bas à droite, près de l’horloge). Si vous voyez la petite icône de tête de lama, c’est que le serveur tourne déjà. Vous n’avez pas besoin de lancer
ollama serve, vous pouvez directement taper votre commandeollama run. - Si vous voulez vraiment le lancer dans votre terminal (pour voir les logs) : Faites un clic droit sur l’icône du lama dans la barre des tâches et cliquez sur Quit. Si l’icône refuse de partir, passez par le Gestionnaire des tâches (Ctrl + Shift + Esc), cherchez “ollama”, et faites “Fin de tâche”.
- En cas de doute sur le port bloqué : Pour vérifier si un autre programme squatte le port d’Ollama, tapez :
netstat -ano | findstr 11434
Si la commande renvoie des lignes avec des chiffres, c’est qu’un processus bloque le passage. Vous n’avez plus qu’à tuer ce processus pour libérer la voie.