Tutorial

Open WebUI Portable: Deinen KI-Workspace & OpenRouter immer auf dem USB-Stick dabei

Mobiler KI-Workspace unter Windows: Open WebUI mit OpenRouter-Anbindung komplett auf einem USB-Stick – ohne Admin-Rechte, ohne Docker und ohne lokale Modelle.

Self-Hosting KI / LLMs Workflow ca. 5 Min. Lesezeit

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.

Tutorial als Markdown-Datei herunterladen

open_webui_portable_usb_tutorial.md — 6 KB

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.
  • 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:

Ordnerstruktur
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 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
  1. 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:

start_webui.bat
@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.