9 min de lecture 7 juin 2026

Configurer Odysseus AI avec Ollama : connecter un modèle local

Un guide ciblé pour la configuration Odysseus AI avec Ollama sous Docker et en natif, avec endpoints, vérification des modèles et dépannage du provider.

Odysseus AI Wiki
Odysseus AI Wiki
Notes éditoriales de fans fondées sur la documentation publique d’Odysseus AI et les pratiques de self-hosting local.
Schéma de configuration Odysseus AI avec Ollama et endpoints de modèles locaux

Réponse rapide: Pour relier Odysseus AI dans Docker à Ollama sur l’hôte, commencez par http://host.docker.internal:11434/v1. Si les deux services sont natifs sur la même machine, essayez http://127.0.0.1:11434/v1. Vérifiez ensuite le service Ollama et la présence d’un modèle avant de modifier le provider.

Dans ce guide

Configurer Odysseus AI avec Ollama demande de séparer deux vérifications : le serveur Ollama doit répondre et Odysseus AI doit l’atteindre depuis le bon réseau d’exécution. Cette page couvre Docker vers l’hôte, les chemins natifs Windows/Linux/macOS, les exemples de modèles locaux et les cas où le provider se connecte sans afficher de modèle.

Choisir l’endpoint Ollama selon le runtime

L’erreur la plus fréquente de configuration Odysseus AI avec Ollama consiste à copier une URL localhost native dans un conteneur Docker. L’endpoint doit décrire l’adresse joignable depuis le processus Odysseus, pas seulement l’endroit où Ollama est installé.

Utilisez host.docker.internal:11434/v1 si Odysseus AI tourne dans Docker et Ollama sur l’hôte. Utilisez 127.0.0.1:11434/v1 si les deux services sont natifs. Testez d’abord Ollama et un modèle avant de déboguer les prompts ou les agents.

Endpoint Ollama de l’hôte depuis Docker
http://host.docker.internal:11434/v1

Configuration Docker vers Ollama sur l’hôte

Une configuration Odysseus AI avec Ollama sous Docker traverse une frontière réseau. localhost dans le conteneur désigne le conteneur lui-même ; l’endpoint de l’hôte doit donc être explicite et Ollama doit écouter sur une adresse accessible.

Gardez le premier test local : prouvez une seule route entre le conteneur et Ollama avant d’exposer des ports ou de changer les tags de modèles.

1. Démarrer Ollama pour qu’il écoute au-delà de son loopback si nécessaire

Si Docker n’atteint pas Ollama, démarrez-le avec un binding d’hôte explicite. Limitez ce binding à un usage local de confiance si vous ne maîtrisez pas l’exposition réseau.

OLLAMA_HOST=0.0.0.0:11434 ollama serve

2. Vérifier qu’Ollama possède au moins un modèle

Odysseus AI peut atteindre l’endpoint sans afficher de modèle utile si Ollama n’en a encore téléchargé aucun. Téléchargez d’abord un petit modèle pour tester la connexion.

ollama list
ollama pull llama3.2:3b

3. Saisir l’endpoint Docker dans les paramètres d’Odysseus AI

Utilisez la base URL compatible OpenAI dans les paramètres du modèle ou du service. N’utilisez pas localhost pour ce parcours Docker-hôte sauf configuration différente de Docker.

http://host.docker.internal:11434/v1

4. Vérifier la santé du conteneur avant les prompts

Si le service Odysseus est dégradé, corrigez-le d’abord. Un endpoint de modèle ne répare ni un démarrage de conteneur cassé, ni un fichier d’environnement manquant, ni une dépendance défaillante.

docker compose ps
docker compose logs --tail=120 odysseus

Configuration native d’Ollama sur Windows, Linux et macOS

Quand Odysseus AI et Ollama tournent nativement dans la même session, localhost désigne généralement la bonne machine. Le port de l’interface peut varier, mais Ollama utilise souvent 11434 si OLLAMA_HOST n’a pas été modifié.

Pour le choix d’installation sur Mac, poursuivez avec le guide macOS ; pour Windows ou le matériel, utilisez les pages de configuration et de prérequis sans élargir cette page à une autre intention.

Configuration Endpoint à essayer en premier Points à surveiller
Odysseus natif Windows + Ollama Windows http://127.0.0.1:11434/v1 Utilisez localhost lorsque les deux services fonctionnent nativement sur le même ordinateur Windows.
Odysseus natif Linux + Ollama http://127.0.0.1:11434/v1 Vérifiez les permissions du service si l’un des processus fonctionne en arrière-plan.
Parcours natif macOS ou Apple Silicon http://127.0.0.1:11434/v1 Le port de l’interface Odysseus peut changer, mais Ollama reste généralement sur 11434.
Odysseus dans Docker + Ollama sur l’hôte http://host.docker.internal:11434/v1 Utilisez le nom d’hôte Docker, car le localhost du conteneur n’est pas la machine hôte.

Corriger les erreurs de provider et d’endpoint Odysseus AI Ollama

Lisez les erreurs par couches : processus Ollama, endpoint joignable, modèle listé, configuration du provider, puis prompts. Cet ordre évite de confondre réseau et qualité du modèle.

Symptôme Cause probable Correctif
Connexion refusée Ollama n’est pas démarré ou n’écoute qu’à un endroit inaccessible à Odysseus. Démarrez Ollama, confirmez le port 11434 et utilisez un binding OLLAMA_HOST explicite pour tester Docker-hôte.
Le navigateur de l’hôte fonctionne mais Docker échoue L’endpoint utilise localhost dans le conteneur. Remplacez l’endpoint par http://host.docker.internal:11434/v1.
Aucun modèle n’apparaît Aucun modèle n’a été téléchargé ou le tag du modèle est incorrect. Exécutez ollama list, téléchargez un petit modèle et sélectionnez le tag exact.
Première réponse lente Le modèle se charge ou est trop volumineux pour la machine. Testez un modèle plus petit avant les agents, les outils ou les documents.
Exposition LAN inattendue Un service a été lié à toutes les interfaces sans limite de confiance. Revenez à un binding localhost uniquement sauf si pare-feu, VPN et authentification sont délibérés.

Checklist finale avant de faire confiance au setup

Une configuration fonctionnelle doit réussir ces contrôles dans l’ordre. Arrêtez-vous au premier échec et corrigez cette couche avant d’avancer.

  1. Ollama répond sur l’hôte et ollama list affiche un modèle.
  2. Le service Odysseus est sain dans Docker ou dans les journaux natifs.
  3. L’endpoint correspond à l’organisation du runtime.
  4. Une petite requête fonctionne avant de passer à des agents ou workflows documentaires plus lourds.
  5. Toute exposition au réseau local est authentifiée et volontaire.
Gardez le premier setup en local

Connecter Odysseus AI à Ollama ne nécessite pas de publier les deux services sur Internet. Gardez-les locaux jusqu’à avoir défini l’authentification, le pare-feu et le reverse proxy.

Notes 2026 pour vérifier une configuration Odysseus AI Ollama

Avant de changer le nom du modèle, vérifiez la frontière d’exécution et l’URL de base. Le même serveur Ollama peut utiliser localhost en natif et host.docker.internal depuis un conteneur.

Un exemple fiable consiste à lister un modèle, tester l’endpoint depuis la même couche d’exécution qu’Odysseus AI, puis enregistrer le provider. Si la première requête échoue, ne changez pas encore le tag du modèle.

Controle Resultat attendu Action si echec
API Ollama de l’hôte L’hôte atteint http://127.0.0.1:11434 avant l’intervention d’Odysseus. Démarrez Ollama, chargez un petit modèle et testez d’abord l’API.
Route Docker vers l’hôte Odysseus en conteneur utilise host.docker.internal:11434/v1. N’utilisez pas localhost dans le conteneur sauf si Ollama partage ce réseau.
Route native Odysseus en natif utilise 127.0.0.1:11434/v1 quand Ollama est sur la même machine. Retirez les noms d’hôte propres à Docker et testez avec un petit prompt.
  1. Cette section aide a separer Docker, l'execution native et les endpoints Ollama avant de modifier la configuration.
  2. Mise a jour avec des notes 2026 sur les sources officielles, l'execution locale, Ollama et les guides lies.
  3. Gardez l’intention de cette page distincte des guides de configuration associés.

FAQ de configuration Odysseus AI avec Ollama

Commencez par http://host.docker.internal:11434/v1 lorsque Odysseus AI est dans Docker et Ollama sur l’hôte. En cas d’échec, vérifiez le binding d’Ollama et le réseau Docker avant de changer le modèle.

Utilisez la base compatible OpenAI avec /v1 lorsque le champ provider attend ce format. Gardez l’URL conforme à la documentation et testez exactement cette adresse.

Non. Ollama est un serveur de modèles séparé dans cette configuration. Odysseus AI s’y connecte, mais ne démarre pas Ollama dans le conteneur.

Si Odysseus AI et Ollama fonctionnent nativement sous Windows, essayez d’abord http://127.0.0.1:11434/v1. Utilisez host.docker.internal seulement si Odysseus est dans Docker et Ollama sur l’hôte.

Ollama peut répondre sans modèle téléchargé ou avec un tag différent. Lancez ollama list, confirmez le tag choisi, puis vérifiez le champ modèle dans Odysseus AI.

En général oui. Ollama fournit le serveur de modèles et Odysseus AI est le workspace qui s’y connecte. Démarrez chaque couche séparément avant de vérifier le lien.

Sources et références officielles

  1. Dépôt GitHub officiel d’Odysseus AI - Conseils sur Docker, Windows, Apple Silicon et les endpoints Ollama.
  2. Documentation de l’API Ollama - Fonctionnement de l’API du serveur de modèles local.
  3. Documentation réseau de Docker Desktop - Comportement du réseau hôte avec host.docker.internal.

Guides de configuration Odysseus AI associés

Dernière mise à jour : 13 août 2026

Retour au Wiki Odysseus AI