Configurer Odysseus AI sur macOS : Mac, MacBook, Apple Silicon et Ollama

Choisir le chemin Mac selon ce que vous voulez vérifier

Pour la plupart des utilisateurs de MacBook et d’iMac, le chemin natif Apple Silicon est le départ le plus clair lorsque les modèles locaux et Ollama sont prioritaires. Docker convient à un test isolé ou reproductible, mais ajoute une couche réseau qui change le sens de localhost.

Utilisez Odysseus AI natif avec Ollama natif sur le Mac. Utilisez host.docker.internal quand Odysseus AI est dans Docker et Ollama sur l’hôte Mac. Décidez du chemin avant de modifier ports ou tags de modèles.

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
./start-macos.sh

Configuration native d’Odysseus AI sur macOS et Apple Silicon

Le chemin natif est généralement le plus direct pour un MacBook ou iMac avec modèles locaux. Vérifiez dépôt, permissions du launcher, Python/dépendances et première URL locale avant d’ajouter Ollama.

Le premier lancement doit prouver que le workspace est sain. Traitez conflit de port et dépendance comme des problèmes de démarrage, pas comme des problèmes de modèle.

1. Clonez le dépôt officiel

Utilisez le dépôt officiel comme source de vérité pour les scripts, issues et changements du README.

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus

2. Lancez le script macOS et lisez la première erreur

La première erreur indique souvent permissions, Python, dépendances ou conflit de port.

chmod +x ./start-macos.sh
./start-macos.sh

3. Ouvrez l’UI locale et terminez la connexion

Si l’application démarre sur le port local documenté, ouvrez cette URL et remplacez toute clé temporaire.

http://127.0.0.1:7860

4. Configurez les modèles seulement ensuite

Une fois le workspace sain, connectez Ollama ou un autre fournisseur dans Settings.

http://127.0.0.1:11434/v1

Docker sur Mac : isolation et accès aux modèles locaux

Docker est pertinent sur macOS pour un test jetable, une frontière de dépendances ou une parité de déploiement. Ce n’est pas forcément le meilleur défaut pour un workflow local Apple Silicon.

Si le conteneur doit atteindre Ollama sur l’hôte Mac, utilisez l’endpoint de l’hôte et ne supposez pas que localhost désigne le Mac. Gardez le premier lancement local.

Connecter Ollama pendant la configuration Odysseus AI sur Mac

Ollama est un serveur de modèles local séparé. Odysseus AI natif et Ollama natif sur le même Mac : http://127.0.0.1:11434/v1. Odysseus AI dans Docker et Ollama sur l’hôte : http://host.docker.internal:11434/v1.

Vérifiez Ollama et un modèle listé avant de dépanner l’interface Odysseus AI. Le workspace peut démarrer alors que l’endpoint ou le tag restent incorrects.

http://127.0.0.1:11434/v1

Dépanner Odysseus AI sur MacBook, iMac et macOS

Vérifiez d’abord launcher et interface locale, puis réseau du runtime, puis Ollama et tag du modèle. Vous séparerez ainsi démarrage Mac et problème provider.

Checklist finale pour une installation Mac

Une installation Mac est prête quand le workspace, l’endpoint modèle et la frontière réseau sont clairs.

1. L’UI s’ouvre localement après un démarrage propre.
2. Le mode natif, Docker ou distant est identifié.
3. Ollama répond séparément avant Odysseus AI.
4. Un petit modèle fonctionne avant agents ou documents.
5. Le workspace n’est pas exposé sans règles réseau.

Notes 2026 pour vérifier la configuration Odysseus AI sur Mac

Le choix Mac dépend surtout de l’emplacement du workspace et du runtime modèle. Apple Silicon natif retire une couche réseau ; Docker isole mais modifie l’accès à l’hôte.

Sur MacBook ou iMac : lancer le workspace, ouvrir l’interface locale, vérifier Ollama, choisir l’endpoint du runtime, puis tester une requête modèle.

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.