Was ist Odysseus?
Ein selbst gehosteter KI-Arbeitsplatz, der auf deiner eigenen Hardware mit deinen eigenen Daten läuft – local-first, privacy-first. Alles drin:
Anbindbar an lokale Modelle (Ollama, llama.cpp, vLLM) oder APIs (OpenAI, OpenRouter). Läuft auch auf dem Handy (PWA).
Voraussetzungen
- 1Docker (empfohlen) – oder
- 2Python 3.11+ für die native Installation
Installation – Docker (empfohlen)
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --buildDanach im Browser öffnen: http://localhost:7000. Ist der Port belegt, in .env den Wert APP_PORT=7001 setzen.
Installation – Native (Linux / macOS)
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 0.0.0.0 --port 7000Installation – Windows (1 Befehl)
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1Für ein lokales Modell auf Windows ist Ollama am einfachsten – in den Settings http://localhost:11434/v1 eintragen.
Loslegen
App öffnen, mit dem generierten Admin-Passwort einloggen, und Modelle / Suche / E-Mail bequem in den Settings konfigurieren. Fertig – deine eigene KI läuft.
Sicherheit: AUTH_ENABLED=true lassen, nie ohne HTTPS/Reverse-Proxy ins offene Internet stellen, und API-Keys/Tokens regelmäßig rotieren. Odysseus hat mächtige Tools (Shell, Datei-Zugriff) – behandle es wie eine Admin-Konsole.