# Open WebUI Portable: Deinen KI-Workspace & OpenRouter immer auf dem USB-Stick dabei **Kategorie:** Self-Hosting / KI & LLMs / Workflow **Zielgruppe:** IT-Enthusiasten, Systemintegratoren, Power-User **Lesezeit:** ca. 5 Minuten --- ## Einleitung Stell dir vor: Du wechselst häufig zwischen verschiedenen Arbeitsplätzen, Schulungsräumen, Homeoffice und Kunden-PCs – möchtest aber überall deine gewohnte KI-Arbeitsumgebung nutzen. Sämtliche Chat-Historien, System-Prompts, Custom Models und Einstellungen sollen dabei exakt so verfügbar sein, wie du sie zu Hause eingerichtet hast. Die Lösung: **Open WebUI** zusammen mit der **OpenRouter API** vollständig **portable auf einem USB-Stick**. In dieser Anleitung zeige ich dir Schritt für Schritt, wie du diesen mobilen KI-Workspace unter Windows aufbaust – **ohne Admin-Rechte**, **ohne Docker** und **ohne speicherintensive lokale Modelle**. --- ## Warum diese Architektur? 1. **Keine Admin-Rechte erforderlich:** Durch den Einsatz einer portablen Python-Umgebung (*WinPython*) muss auf dem Gast-PC nichts installiert werden. 2. **Schlank & extrem mobil:** Weil die Modelle über die OpenRouter-API in der Cloud laufen, benötigst du keine Gigabytes an lokalen Modell-Weights auf dem Stick. Ein einfacher 8GB-Stick reicht völlig aus. 3. **100 % Datenkontrolle & Privatsphäre:** Sämtliche SQLite-Datenbanken, Chatverläufe und API-Konfigurationen werden über Umgebungsvariablen direkt im `data/`-Ordner auf dem USB-Stick gespeichert. Auf dem Gast-PC hinterlässt du keine Spuren. --- ## Voraussetzungen * **USB-Stick oder externe SSD:** Idealerweise USB 3.0/3.1 für schnelle Zugriffszeiten. * **WinPython:** Die schlanke "Dot"-Variante (z. B. Python 3.11 oder 3.12). * **OpenRouter API-Key:** Einen kostenlosen Account und Key erhältst du unter [openrouter.ai](https://openrouter.ai). * **Windows-PC:** Als Gast-System (Windows 10/11). --- ## Ziel-Ordnerstruktur auf dem USB-Stick Am Ende der Einrichtung sieht die Ordnerstruktur auf deinem USB-Stick (z. B. Laufwerk `E:\`) folgendermaßen aus: ```text USB-Stick (E:\) ├── WinPython\ <- Portable Python-Laufzeitumgebung ├── data\ <- Automatisch erstellter Datenordner (DB, Chats, Settings) └── start_webui.bat <- Das zentrale Start-Skript ``` --- ## Schritt-für-Schritt-Anleitung ### Schritt 1: WinPython auf den USB-Stick entpacken 1. Lade dir von der offiziellen [WinPython GitHub Release Page](https://github.com/winpython/winpython/releases) eine **WinPython 64bit Dot-Edition** herunter (z. B. `Winpython64-3.11.x.xDot.exe`). 2. Führe die heruntergeladene Datei aus und wähle als Zielpfad das Hauptverzeichnis deines USB-Sticks aus. 3. Benenne den entpackten Ordner der Einfachheit halber in `WinPython` um. --- ### Schritt 2: Open WebUI in WinPython installieren 1. Öffne auf dem USB-Stick den Ordner `WinPython`. 2. Starte die Datei `WinPython Command Prompt.exe`. Es öffnet sich ein Terminalfenster, das isoliert auf die Python-Instanz des Sticks zugreift. 3. Führe folgenden Befehl aus, um Open WebUI zu installieren: ```cmd pip install open-webui ``` 4. Sobald die Installation abgeschlossen ist, kannst du das Terminalfenster wieder schließen. --- ### Schritt 3: Das Start-Skript (`start_webui.bat`) erstellen Damit Open WebUI seine Daten auf dem Stick ablegt und automatisch deine OpenRouter-Zugangsdaten nutzt, erstellen wir ein intelligentes Batch-Skript. Erstelle im Stammverzeichnis deines USB-Sticks eine neue Datei namens `start_webui.bat` und füge folgenden Code ein: ```cmd @echo off setlocal enableextensions :: 1. Dynamischen Pfad des USB-Sticks ermitteln (egal welcher Laufwerksbuchstabe) set "PORTABLE_DIR=%~dp0" :: 2. Datenverzeichnis explizit auf den USB-Stick umleiten set "DATA_DIR=%PORTABLE_DIR%data" :: 3. OpenRouter als OpenAI-kompatible Schnittstelle konfigurieren set "OPENAI_API_BASE_URL=https://openrouter.ai/api/v1" set "OPENAI_API_KEY=sk-or-v1-DEIN_OPENROUTER_API_KEY" echo =================================================== echo Open WebUI Portable wird gestartet... echo Datenverzeichnis: %DATA_DIR% echo =================================================== :: 4. Portable Python-Umgebung aktivieren call "%PORTABLE_DIR%WinPython\scripts\env.bat" :: 5. Open WebUI Server starten open-webui serve ``` > ⚠️ **Wichtig:** Ersetze `sk-or-v1-DEIN_OPENROUTER_API_KEY` durch deinen tatsächlichen OpenRouter API-Schlüssel. --- ## Praxis-Test: So nutzt du den Stick unterwegs 1. Stecke den USB-Stick in einen beliebigen Windows-PC ein. 2. Öffne den Stick im Explorer und starte die Datei `start_webui.bat` per Doppelklick. 3. Öffne deinen bevorzugten Webbrowser und rufe die Adresse auf: `http://localhost:8080` 4. **Ersteinrichtung:** Beim allerersten Start legst du deinen lokalen Admin-Account an. Dieser existiert ausschließlich in der SQLite-Datenbank auf deinem Stick (`data/webui.db`). 5. **Modellauswahl:** Sobald du eingeloggt bist, stehen dir alle über OpenRouter verfügbaren Modelle (z. B. Claude 3.5 Sonnet, GPT-4o, DeepSeek, Llama 3.3) sofort in der Modellauswahl zur Verfügung! --- ## Sicherheit & Best Practices * 🔒 **USB-Stick verschlüsseln (Dringend empfohlen!):** Da im Start-Skript dein API-Key im Klartext steht und deine Chat-Verläufe in der Datenbank gespeichert werden, solltest du den USB-Stick mit **BitLocker To Go** (in Windows Pro/Enterprise enthalten) oder einem **VeraCrypt-Container** schützen. * 🚀 **Hardware-Tipp:** Nutze einen schnellen USB 3.1 Stick oder eine portable NVMe-SSD. Da Python aus vielen kleinen Dateien besteht, profitiert der Systemstart spürbar von hohen I/O-Raten. * 🌐 **Internetverbindung:** Da die Modellanfragen an OpenRouter gesendet werden, benötigt der Gast-PC eine aktive Internetverbindung. --- ## Fazit Mit dieser Methode verwandelst du einen einfachen USB-Stick in ein vollgestopftes, mobiles KI-Hauptquartier. Du bist unabhängig von Admin-Rechten, schützt deine Privatsphäre und hast an jedem Rechner Zugriff auf die besten Sprachmodelle des Marktes. *Wie sichert ihr eure mobilen Dev-Tools ab? Nutzt ihr BitLocker oder bevorzugt ihr Open-Source-Lösungen wie VeraCrypt? Schreibt es gerne in die Kommentare!*