10 Min. Lesezeit 11. Juni 2026

Odysseus AI auf macOS einrichten: Apple Silicon, Docker und Ollama

Praktischer Mac-Leitfaden für den nativen Apple-Silicon-Pfad, sinnvolle Docker-Nutzung, Ollama-Endpunkte und sichere lokale Prüfungen.

Odysseus AI Wiki

Fan-made editorial notes based on public Odysseus AI documentation, GitHub setup discussions, and local self-hosting patterns.

Odysseus AI auf macOS einrichten: Apple Silicon, Docker und Ollama

Kurzantwort: Auf einem Apple-Silicon-Mac ist der native Pfad meist der bessere erste Test, wenn lokale Beschleunigung und weniger Netzwerkverwirrung wichtig sind. Docker eignet sich für isolierte Tests, ist aber nicht immer ideal für Ollama auf demselben Mac.

Mac-Nutzer haben bei Odysseus AI meist zwei Ziele: einen sauberen schnellen Start oder ein Workspace-Setup mit Ollama und lokalen Modellen auf einem M-Series-Mac. Dieser Leitfaden trennt beide Ziele, bevor du Ports, Umgebungsdateien oder Modelloptionen änderst.

Wähle den Mac-Pfad nach deinem ersten Ziel

Wenn du nur prüfen willst, ob Odysseus AI startet, ist Docker ein kontrollierter Weg mit klarer Abhängigkeitstrennung. Wenn dein Ziel lokale Modelle auf einem Apple-Silicon-Mac sind, ist der native Pfad meist der bessere erste Test.

Es gibt keinen universell besten Pfad. Docker beantwortet die Frage nach einem reproduzierbaren Containerstart. Der native Pfad beantwortet, ob dein Mac den Workspace nahe bei lokalen Modellen, Dateien und Tools betreiben kann.

Nativer Startpunkt für macOS

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

Nativer Apple-Silicon-Pfad: erst Umgebung, dann Modelle

Der native macOS-Pfad ist wichtig, weil Apple-Silicon-Nutzer Ollama, lokale Modelle und Dateien oft direkt neben dem Workspace halten wollen. Prüfe zuerst Repository, Ausführungsrecht, Python-Abhängigkeiten und lokalen Port.

Ein sauberer Erststart sollte eine erreichbare lokale Oberfläche zeigen und dich durch Einrichtung oder Login führen. Generierte Passwörter und lokale Secrets gehören nicht in öffentliche Screenshots.

1. Offizielles Repository klonen

Nutze das offizielle Repository als Quelle für Scripts, Issues und README-Änderungen.

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus

2. macOS-Launcher ausführen und ersten Fehler lesen

Der erste Fehler zeigt meist Berechtigungen, Python, Abhängigkeiten oder Portkonflikt.

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

3. Lokale UI öffnen und Erstlogin abschließen

Wenn die App auf dem dokumentierten Port startet, öffne diese URL und ersetze temporäre Zugangsdaten.

http://127.0.0.1:7860

4. Modelle erst danach konfigurieren

Verbinde Ollama oder andere Anbieter in Settings, sobald der Workspace selbst gesund ist.

http://127.0.0.1:11434/v1

Docker auf macOS: nützliche Isolation mit Tradeoff

Docker ist auf dem Mac sinnvoll für Wegwerf-Tests, klare Abhängigkeitsgrenzen oder serverähnliche Validierung.

Der häufigste Fehler ist ein falsches localhost-Modell: im Container meint localhost den Container, auf dem Host meint es den Mac.

Option	Am besten für	Darauf achten
Apple Silicon nativ	Lokale Modelle, weniger Netzwerkschichten und einfachere Ollama-Kopplung	Python und lokale Abhängigkeiten müssen sauber bleiben.
Docker auf macOS	Saubere Tests, isolierte Abhängigkeiten und Deployment-Nähe	host.docker.internal verwenden, wenn der Container Ollama auf dem Host erreichen muss.
Remote-Linux-Host	Dauerbetrieb, Server-GPUs oder Teamzugriff	Nicht ohne Auth, Firewall und Proxy-Regeln öffnen.

Ollama, Metal-Beschleunigung und Endpunktwahl

Ollama ist normalerweise ein separater Modellserver. Auf dem Mac ist diese Trennung hilfreich, weil Ollama im lokalen Runtime-Umfeld bleiben kann und Odysseus AI nur den kompatiblen API-Endpunkt nutzt.

Nutze 127.0.0.1, wenn Odysseus AI und Ollama nativ auf demselben Mac laufen. Nutze host.docker.internal, wenn Odysseus AI in Docker läuft und Ollama auf dem Host.

Nativer Mac-Endpunkt zu lokalem Ollama

http://127.0.0.1:11434/v1

Odysseus AI auf macOS Fehlerbehebung

Gehe von Start zu Netzwerk und dann zur Modellauswahl. Wenn die UI nicht gesund ist, sind Modellfehler meist zweitrangig.

Symptom	Wahrscheinliche Ursache	Lösung
macOS-Script startet nicht	Ausführungsrecht, Shell-Policy oder Abhängigkeit fehlt.	chmod +x ausführen, aus dem Repo-Root starten und ersten Fehler lesen.
Browser öffnet UI nicht	App hört noch nicht oder Port ist belegt.	Terminalausgabe prüfen und Port freimachen.
Ollama geht im Terminal, nicht in Odysseus	Endpunkt passt nicht zu nativ oder Docker.	127.0.0.1 nativ, host.docker.internal aus Docker.
Erster Prompt ist langsam	Modell lädt oder Speicher ist knapp.	Kleines Modell testen, bevor Agents oder Dokumente laufen.
Zugriff von anderem Gerät	Lokale Bindung schützt den Dienst.	Auth, Firewall und Proxy planen, bevor du öffnest.

Abschlusscheck für die Mac-Installation

Eine Mac-Installation ist bereit, wenn Workspace, Modellendpunkt und Netzwerkgrenze klar sind.

Die UI öffnet lokal nach sauberem Start.
Du kennst nativen, Docker- oder Remote-Modus.
Ollama antwortet separat vor Odysseus AI.
Ein kleines Modell funktioniert vor Agents oder Dokumenten.
Der Workspace ist nicht ohne Regeln im Netzwerk offen.

Ersten Test lokal halten

Die sichere Vorgabe ist localhost für Odysseus AI und Ollama, bis der Ablauf verstanden ist.