Odysseus: Tipps und Tricks für dein self-hosted AI-Workspace
Hol mehr aus Odysseus heraus: Agenten und MCP, Deep Research und Websuche, E-Mail und Kalender, optionale Features und eine saubere Absicherung.

Hol mehr aus Odysseus heraus: Agenten und MCP, Deep Research und Websuche, E-Mail und Kalender, optionale Features und eine saubere Absicherung.

Odysseus kann viel mehr als Chatten. Diese Tipps zeigen, wie du die stärkeren Teile freischaltest: Agenten mit Werkzeugen und MCP, Deep Research mit Websuche, E-Mail und Kalender, praktische Zusatzfunktionen und eine solide Absicherung. Setzt eine installierte Odysseus-Instanz voraus.
Browser-MCP aktivieren, Websuche und Deep Research nutzen, E-Mail und Kalender einrichten, optionale Pakete nachrüsten und die Sicherheitseinstellungen prüfen.
Odysseus registriert beim Start ein paar eingebaute MCP-Server. Der Browser-MCP für Seitennavigation, Screenshots und Vision startet nur, wenn sein Paket lokal vorhanden ist. Aktiviere ihn einmalig:
Danach startest du Odysseus neu, und der Server meldet sich beim Start an. Deine Agenten können damit Webseiten öffnen und lesen, zusätzlich zu Shell, Dateien, Skills und Speicher.
Die Websuche läuft über das mitgelieferte SearXNG, ohne dass Anfragen an einen externen Dienst gehen. Damit recherchiert Deep Research mehrstufig, liest Quellen und schreibt einen Bericht. Möchtest du DuckDuckGo als zusätzliche Quelle, rüstest du das optionale Paket ddgs nach (siehe unten).
Odysseus bindet Postfächer per IMAP und SMTP ein, mit Triage, Zusammenfassungen und Antwortentwürfen. Notizen, Aufgaben und Kalender lassen sich per CalDAV synchronisieren.
Die E-Mail-Konten nutzen aktuell Nutzername und Passwort per IMAP/SMTP. Outlook und Microsoft 365 verlangen meist OAuth, ein normales Postfach-Passwort schlägt dort fehl.
Einige Funktionen stecken in optionalen Paketen, die standardmäßig nicht installiert sind:
| Paket | Feature |
|---|---|
faster-whisper | Lokale Sprache-zu-Text, also Mikrofon zu Text |
ddgs | DuckDuckGo als zusätzlicher Suchanbieter |
PyMuPDF | PDF-Anzeige und Formular-Ausfüllen (AGPL) |
markitdown | Textextraktion aus Office- und EPUB-Dateien |
Im Docker-Setup baust du sie über ein Build-Argument mit ein:
Odysseus ist eine Admin-Konsole, entsprechend lohnt ein kurzer Sicherheits-Check:
data/auth.json und schalte die offene Registrierung ab, sofern du sie nicht bewusst willst. Lass nur dein eigenes Konto als Admin.Der Workspace selbst ist schlank, die Last kommt von lokalen Modellen. Reicht die Leistung nicht, hilft entweder mehr CPU und RAM oder der Umstieg auf einen GPU-Server für schnelle lokale Inferenz. Wie du GPU-Modelle einrichtest, steht in Odysseus mit GPU. Upload-Grenzen wie ODYSSEUS_CHAT_UPLOAD_MAX_BYTES passt du bei Bedarf in der .env an.
Aktuell hältst du Odysseus mit einem Pull und Rebuild:
Alle Daten liegen im Ordner data/. Sichere ihn regelmäßig über die Backups im Panel, besonders vor größeren Updates.
Aktiviere den Browser-MCP mit npx -y @playwright/mcp@latest --version und starte Odysseus neu. Danach können Agenten Seiten öffnen und lesen.
Ja. Lege in data/auth.json fest, wer Admin ist, und vergib pro Nutzer Rechte. Für ein geteiltes Setup solltest du die offene Registrierung abschalten.
Der komplette Zustand liegt in . Sichere diesen Ordner, dann kannst du deine Instanz jederzeit wiederherstellen.
VPS auf AMD EPYC mit NVMe-SSD, voller Kontrolle und Hosting in Deutschland.
VPS konfigurieren
data/npx -y @playwright/mcp@latest --versiondocker compose build --build-arg INSTALL_OPTIONAL=true
docker compose up -dgit pull
docker compose up -d --build