Odysseus-Anleitung: Selbst gehosteten KI-Workspace einrichten

Ein eigener KI-Workspace, der deine Mails liest, deinen Kalender kennt und deine Daten für sich behält: Das klingt nach einem Wochenendprojekt, dauert mit Odysseus aber keine halbe Stunde. In dieser Odysseus-Anleitung zeige ich dir Schritt für Schritt, wie du das Tool einrichtest, ein KI-Modell verbindest und die wichtigsten Funktionen nutzt. Falls du noch gar nicht weißt, worum es geht: In Was ist Odysseus? habe ich das Tool im Überblick vorgestellt.

Eigener PC oder VPS: Wo soll Odysseus laufen?

Du hast zwei Möglichkeiten, Odysseus zu hosten.

Option eins ist dein eigener PC oder Laptop. Das empfehle ich dir, wenn Datenschutz für dich die absolut höchste Priorität hat und du ausschließlich mit lokalen Modellen arbeiten willst. Dann sollte allerdings eine gute Grafikkarte drinstecken, sonst laufen nur schwache Modelle. Die offizielle Installations-Anleitung findest du direkt im GitHub-Repository von Odysseus.

Option zwei, und die empfehle ich dir für den Anfang: ein VPS, also ein gemieteter virtueller Server. Den bekommst du in rund drei Minuten zum Laufen, Odysseus ist darauf rund um die Uhr erreichbar, und dein PC muss nicht durchlaufen. Odysseus selbst hat keine eigene Cloud, aber bei Hostinger gibt es einen VPS, auf dem Odysseus schon vorinstalliert ist. Alle Schritte in diesem Artikel funktionieren genauso, wenn du lokal hostest.

Schritt 1: Odysseus bereitstellen

Wichtig zu wissen: Wenn du dir für n8n oder Paperclip schon einen VPS eingerichtet hast, brauchst du keinen neuen. Geh in deinem VPS links in den Docker-Manager, dann auf Katalog, such nach Odysseus, klick auf Wählen, leg Nutzername und Passwort für die Odysseus-App fest und geh auf Bereitstellen. Den Rest übernimmt der Hoster für dich.

Bei einem neuen VPS läuft es fast genauso: Nach der Bestellung gehst du auf Loslegen, vergibst Nutzername und Passwort für den Odysseus-Admin (das Passwort unbedingt speichern) und klickst auf Bereitstellen. Die Einrichtung dauert etwa fünf Minuten. Für den Anfang reicht ein kleiner Plan völlig aus.

Falls du Odysseus danach nicht direkt siehst: Geh in die Übersicht deines VPS und dann im Docker-Manager auf Projekte. Dort taucht Odysseus auf und lässt sich öffnen. Jetzt noch mit Benutzername und Passwort einloggen, und du bist drin.

Schritt 2: Ein KI-Modell verbinden

Die Oberfläche sieht aus wie bei ChatGPT oder Claude: Chatleiste unten, vergangene Chats links, oben ein Button für neue Chats. Was noch fehlt, ist das Gehirn. Odysseus braucht ein KI-Modell, und dafür gibt es zwei Wege: einen der großen Anbieter per API anbinden oder eigene lokale Modelle hosten.

Auf einem VPS ist die API-Variante meist die beste Wahl, weil ein kleiner Server keine starken lokalen Modelle stemmt. Dein Profil und dein Kontextwissen bleiben trotzdem auf deiner Infrastruktur. Lokale Modelle lohnen sich vor allem, wenn Odysseus auf einem PC mit guter Grafikkarte läuft. Dazu kommen wir am Ende beim Cookbook.

So verbindest du dich mit Anthropic:

1. Geh auf Select Model, dann auf das Plus und im Reiter Add Models auf API.
2. Wähl Anthropic aus. Die Voreinstellungen kannst du so lassen.
3. Erstell dir in der Anthropic-Konsole unter API-Schlüssel einen neuen Schlüssel, nenn ihn zum Beispiel "Odysseus" und kopier ihn.
4. Füg den Schlüssel in Odysseus ein und teste die Verbindung.
5. Klick auf Add. Die Anthropic-Modelle tauchen jetzt automatisch in der Modell-Auswahl auf.

Für ChatGPT-Modelle ist der Ablauf identisch, nur dass du den Schlüssel auf platform.openai.com erstellst.

Zum Testen wählst du ein Modell wie Sonnet 4.6 aus und schickst ein kurzes "Hey" ab. Bei mir kam die Antwort auf Englisch zurück, das stellen wir gleich mit dem Brain um. Schön finde ich die Kostenübersicht: Odysseus zeigt dir direkt an, was die Nachricht gekostet hat (bei mir 0,1 Cent) und wie viel vom Kontextfenster verbraucht ist.

Schritt 3: E-Mail einbinden

Jetzt kommt der Teil, der Odysseus wirklich produktiv macht. Geh in die Einstellungen, dann auf Integrations, auf Add Integration und wähl E-Mail aus.

Bei Gmail brauchst du ein App-Passwort, also ein Passwort, das du in deinem Google-Konto extra für diese eine App anlegst. Als Nutzername trägst du deine E-Mail-Adresse ein, als Passwort das App-Passwort. Andere Anbieter bindest du über Custom ein. Ich hoste meine E-Mail zum Beispiel bei Hostinger und bin genau diesen Weg gegangen. Mit einem Klick auf Test prüfst du, ob die Verbindung steht.

Danach stellst du unten rechts auf Agent (nicht auf Chat) und schreibst zum Beispiel: "Fasse meine letzten fünf Mails zusammen." Odysseus verbindet sich mit deinem Postfach und liefert die Zusammenfassung.

Beim Schreiben von Mails gefällt mir die Umsetzung: Es öffnet sich ein Splitscreen, in dem dich die KI als Sparringspartner unterstützt, aber die Mail nicht selbst abschickt. Den letzten Klick machst du.

Schritt 4: Kalender verbinden

Der Kalender läuft über denselben Weg: Einstellungen, Integrations, Add Integration, diesmal CalDAV-Kalender. Je nachdem, welchen Kalender du nutzt, kannst du dich bei der Einrichtung direkt von Odysseus unterstützen lassen.

Für den Google Kalender gibt es einen Workaround über eine spezielle Server-URL, die du im Feld Server URL einträgst. Nutzername ist deine E-Mail-Adresse, als Passwort erstellst du dir wieder ein App-Passwort bei Google. Nach dem Verbindungstest sollte Connected erscheinen, und im Kalender-Reiter siehst du deine Termine. Falls nicht: In den Einstellungen unter Sync einmal auf Sync Now klicken.

Schritt 5: Das Brain, dein Gedächtnis

Odysseus hat eine eingebaute Memory-Funktion, das Brain. Damit merkt sich der Workspace Dinge über alle Chats hinweg, und du kannst jede Erinnerung links im Brain-Reiter einsehen. Auch Skills, also gespeicherte Arbeitsabläufe, landen dort.

Eine Sache musst du dabei wissen: Das Brain funktioniert nur im Agent-Modus. Im Chat-Modus ist das Modell praktisch blind. Als ich im Chat-Modus geschrieben habe "Bitte merke dir, dass wir ab jetzt Deutsch sprechen", hat das Modell zwar freundlich zugestimmt. Auf Nachfrage gab es dann aber zu, gar kein Werkzeug zum Speichern zu haben, und im Brain-Reiter war nichts angekommen.

Im Agent-Modus sah das anders aus: gleiche Anweisung, und Odysseus ruft sichtbar die Funktion Manage Memory auf. Im Brain stand danach die Erinnerung "Der Benutzer möchte auf Deutsch kommunizieren". Im Agent-Modus kannst du außerdem über die Lupe in der Seitenleiste die Websuche aktivieren und über das Programmier-Symbol Shell-Zugriff geben, damit Odysseus Befehle ausführen und Pakete installieren kann.

Deep Research ausprobieren

Deep Research ist eine meiner Lieblingsfunktionen, du findest sie links als eigenen Reiter. Du stellst eine Frage, und Odysseus durchsucht in mehreren Runden Quellen, um dir am Ende einen ausführlichen, quellenbasierten Bericht zu schreiben.

Ich habe als Test recherchieren lassen, was der EU AI Act für ein mittelständisches Unternehmen bedeutet. Die Rundenzahl habe ich auf Auto gelassen, als Endpunkt Anthropic gewählt und als Modell Sonnet 4.6. Nach knapp zehn Minuten kam ein Bericht zurück mit Executive Summary, einem Zehn-Schritte-Leitfaden zur Compliance, Zitaten und funktionierenden Links, unter anderem zur Bundesnetzagentur.

Über den Discuss-Button startest du danach einen Chat direkt auf Basis des Berichts und der gefundenen Quellen. Du kannst Rückfragen stellen und einzelne Punkte vertiefen, alles auf deinem eigenen System.

Lokale Modelle mit dem Cookbook

Zum Schluss die Funktion, die ich so in keinem anderen KI-Tool gesehen habe: das Cookbook. Es scannt automatisch deine Hardware und schlägt dir die Open-Source-Modelle vor, die am besten dazu passen, inklusive Score, der einschätzt, wie gut die Modelle wirklich sind.

Auf einem VPS laufen nur kleine Modelle, dafür ist so ein Server schlicht nicht gebaut. Auf einem PC mit guter Grafikkarte oder viel RAM kannst du deutlich stärkere Modelle hosten. Ich habe zum Testen ein kleines Gemma-Modell gewählt: anklicken, auf Run drücken, und das Modell wird heruntergeladen. Danach findest du es im Reiter Serve und startest es über Launch.

In einem neuen Chat wählst du das Modell dann wie jedes andere aus. Bei meinem Test hat es nach etwa einer halben Minute Bedenkzeit geantwortet, komplett lokal, ohne dass die Anfrage das System verlassen hat.

Mein Fazit

Mehr brauchst du für den Start nicht: Odysseus bereitstellen, ein Modell verbinden, Mail und Kalender einbinden, und du hast einen KI-Workspace, bei dem alle Daten unter deiner Kontrolle stehen. Wenn du später mehr automatisieren willst, kannst du auf demselben Server zu einem fortgeschrittenen KI-Agenten wie Hermes wechseln. Wie der Einstieg dort aussieht, zeige ich dir in meiner Hermes AI Anleitung.