Fiche mémo Ollama

Choisir la voie

Besoin	Repère
Modèle local	modèle téléchargé localement et point d'accès local ; exclure tout nom/tag `:cloud`
Modèle cloud	tag `:cloud` dans l'app/CLI : prompt transmis à Ollama cloud, sans téléchargement nécessaire
API locale	`http://localhost:11434/api` ; boucle locale, sans authentification selon la documentation
API cloud	`https://ollama.com/api` ; réseau externe et clé API
Interface OpenAI compatible	local `http://localhost:11434/v1`, cloud `https://ollama.com/v1`

Ni l'application locale, ni le point d'accès localhost, ni l'absence de téléchargement ne garantissent à eux seuls une requête locale : confirmer l'origine du modèle et exclure :cloud. Les prompts/réponses cloud sont traités par le service selon les déclarations d'Ollama ; la FAQ mentionne aussi des données de compte et des métadonnées d'usage limitées. Ne jamais envoyer des données réelles sensibles sans autorisation.

Repères par système

Système	Exigence officielle consultée	Installation / données / journaux
macOS	Sonoma 14+ ; Apple Silicon (CPU/GPU indiqué) ou x86 (CPU)	DMG vers Applications ; l'app peut demander de créer le lien CLI `/usr/local/bin`. Modèles/configuration `~/.ollama`, journaux `~/.ollama/logs`.
Linux	Pas de version minimale universelle de distribution indiquée dans la page consultée	Installateur, archive manuelle ou service `systemd` sont des voies distinctes ; commandes manuelles peuvent exiger `sudo`. Journaux service avec `journalctl`; chemin modèles selon l'installation/FAQ.
Windows	Windows 10 22H2+, Home ou Pro	App native utilisateur, sans Administrateur ; 4 Go minimum pour le binaire, plus pour les modèles. Modèles/configuration `%HOMEPATH%\.ollama`, journaux `%LOCALAPPDATA%\Ollama`.

Consulter la page officielle du système avant installation ou mise à jour. Ne pas exécuter par défaut le script shell Linux téléchargé par curl | sh.

CLI : lecture et effets

Commande	Effet	Prudence
`ollama ls`	liste les modèles locaux disponibles	lecture ; bon point de départ sur une installation déjà existante
`ollama ps`	liste les modèles chargés	lecture de l'état du service ; renseigne le processeur utilisé si disponible
`ollama show <modèle-local>`	inspecte un modèle local	employer un nom déjà listé
`ollama run <modèle>`	démarre une conversation	peut télécharger si absent ; `:cloud` est distant même sans téléchargement
`ollama pull <modèle>`	télécharge un modèle	réseau et espace disque ; consentement explicite
`ollama stop <modèle>`	arrête un modèle en cours	effet temporaire sur le service
`ollama rm <modèle>`	supprime un modèle	destructif ; accord et vérification préalables
`ollama serve`	démarre le serveur	ne pas lancer une seconde instance sans connaître la configuration

Les commandes d'inspection à utiliser uniquement si Ollama est déjà installé :

Terminal

ollama lsollama ps

Contexte : terminal du système utilisé.
Droits : utilisateur normal.
Effet : lecture seule ; le service doit être disponible pour voir les modèles chargés.
Vérification : comparer la liste des modèles avec ceux réellement présents. La liste ne suffit pas à garantir qu'un appel ultérieur sera local : exclure les modèles/tag :cloud. Ne pas enchaîner automatiquement sur pull, run, stop ou rm.
Retour arrière : sans objet.

Modelfile

Structure minimale illustrant une base déjà locale :

FROM <nom-d'un-modele-deja-present>
SYSTEM Réponds en français et signale les incertitudes.

FROM choisit le modèle de base ; SYSTEM décrit les consignes. La documentation décrit aussi PARAMETER, TEMPLATE et d'autres instructions.

Attention, effet notable. Cette commande peut créer ou modifier une configuration. Lire le contexte, les droits et l’effet attendu indiqués après le bloc ; ne jamais l’exécuter sur un système réel sans validation, d’abord dans un environnement de test.

Terminal

ollama create cours-demo -f Modelfile

Contexte : terminal, dossier contenant Modelfile ; facultatif, à lancer seulement après accord, si la base est téléchargée localement (et non <nom>:cloud) et l'espace disque suffisant.
Droits : utilisateur normal.
Effet : crée un nouveau modèle local et consomme du stockage. Ne pas utiliser de modèle absent : sa récupération pourrait utiliser le réseau.
Vérification : ollama ls montre le nom créé.
Retour arrière : ollama rm cours-demo (destructif, nom à relire).

API et réseau

Un appel local avec un modèle/tag :cloud reste un appel distant. Ne pas déduire l'emplacement du calcul de la seule URL localhost.
Écoute locale par défaut documentée : 127.0.0.1:11434.
L'API locale ne demande pas d'authentification selon la documentation.
Changer OLLAMA_HOST peut rendre l'API accessible sur le réseau : ne pas le faire dans le cadre de cette fiche.
L'accès cloud direct utilise une clé ; ne jamais la placer dans du code navigateur, un dépôt ou une URL.
La FAQ documente OLLAMA_NO_CLOUD=1 ou disable_ollama_cloud: true dans ~/.ollama/server.json pour désactiver les fonctions cloud. Modification facultative : confirmer l'impact (modèles cloud et recherche web indisponibles), sauvegarder la configuration, appliquer la procédure de l'OS et redémarrer l'application/service.

Configuration par OS

OS / mode	Méthode documentée
Application macOS	variable via `launchctl`, puis redémarrer l'application
Linux avec service `systemd`	surcharge de l'unité du service ; nécessite généralement les droits administrateur, puis rechargement/redémarrage
Application Windows	variable d'environnement utilisateur ; quitter puis relancer Ollama

Ne pas modifier ces réglages en exercice. Les emplacements et droits de modèle varient selon la voie d'installation. Ne pas publier de chemins personnels.

Dépannage sans divulguer

OS / mode	Repère officiel
macOS	`~/.ollama/logs/server.log`
Linux avec `systemd`	`journalctl -u ollama`
Windows	`%LOCALAPPDATA%\Ollama\server.log`

Lire les journaux localement. Avant toute transmission, vérifier et expurger prompts, chemins personnels, identifiants et données d'infrastructure.

Pour un GPU, vérifier la page matérielle officielle : exigences et pilotes varient selon fabricant, système et version. Ne pas installer ni changer de pilote sur la seule base de cette fiche.

Avant de lancer une commande

Confirmer l'OS et la méthode d'installation.
Lire la référence officielle à jour.
Vérifier si l'opération est lecture seule, réseau, modificatrice ou destructive.
Confirmer le nom du modèle et qu'il est présent localement.
Demander accord avant téléchargement, création, suppression, changement de service ou exposition réseau.
Vérifier le résultat sans publier les journaux.