Zum Hauptinhalt springen
Der Tokios-Connector ist eine kleine Konsolenanwendung, die Sie auf dem Rechner neben Ihrem Modell ausführen. Er wählt sich über ein einziges WebSocket zu Tokios und leitet Anfragen an Ihr lokales Modell weiter — keine eingehenden Ports, keine öffentliche IP, keine Firewall-Änderungen. Sie installieren und paaren ihn über den Setup wizard der Konsole mit einem einmaligen Pairing-Code. Für den Standardpfad bearbeiten Sie keine Konfigurationsdatei von Hand — der Connector erhält sein Token sicher über den Tunnel, nachdem Sie das Gerät genehmigt haben.

​
1. Pairing-Code abrufen

Klicken Sie im Tab Setup der Konsole auf Start pairing (Schritt 1). Tokios zeigt einen Pairing-Code wie TKS-XXXX-XXXX, gültig für etwa 15 Minuten. Lassen Sie den Tab geöffnet.

​
2. Den Connector installieren und starten

Führen Sie auf dem Rechner neben Ihrem Modell den Einzeiler aus, den die Konsole für Ihr Betriebssystem anzeigt.
Windows 10 & 11 (x64). In PowerShell:
Ist tokios-connector bereits installiert? Überspringen Sie den Installer und übergeben Sie den Pairing-Code direkt:

​
3. Das Gerät genehmigen

Der Connector wählt sich nach außen und erscheint in der Konsole. Im Tab Setup (oder im Tab Connectors) approve Sie das Gerät. Tokios liefert dann das Token des Connectors über den Tunnel — es wird niemals auf dem Bildschirm angezeigt oder in eine Datei eingefügt.
Der Connector wählt nur nach außen; er lauscht niemals auf einem Port, daher benötigt Ihre Firewall keine eingehenden Regeln.
Sobald er verbunden ist, registrieren Sie Ihr Modell und erstellen einen API-Schlüssel.

​
Fortgeschritten: mehrere Modelle mit einer Konfigurationsdatei bereitstellen

Um mehrere Modelle durch einen Connector bereitzustellen, starten Sie den Connector mit einer JSON-Konfiguration, die jeden Upstream definiert, anstatt ein einzelnes Modell zu paaren. Siehe Connector Config.

​
Was der Installer auf Ihrem Rechner ändert

  • Installationsverzeichnis. Die Connector-Binärdatei und ihre tokios-connector.json liegen zusammen in ~/.tokios/connector (macOS und Linux) oder %LOCALAPPDATA%\Tokios\connector (Windows). Übergeben Sie --dir / -InstallDir, um einen anderen Ordner zu wählen.
  • PATH. Auf macOS und Linux erstellt der Installer einen Symlink der Binärdatei nach ~/.local/bin und, falls sich dieser Ordner nicht auf Ihrem PATH befindet, fügt 1 Zeile mit der Markierung # tokios-connector PATH in Ihr Shell-Profil ein (.zshrc, .bashrc oder .profile). Er fügt die Zeile niemals zweimal hinzu, gibt aus, was er getan hat, und die Zeile bleibt bei der Deinstallation bestehen, da andere Tools denselben Ordner verwenden können. Um es rückgängig zu machen, löschen Sie diese Zeile. Auf Windows fügt er den Standard-Installationsordner zu Ihrem Benutzer-Path hinzu; tokios-install -Uninstall entfernt ihn. Übergeben Sie --no-path / -NoPath, um all dies zu überspringen.
  • Sonst nichts. Keine Systemdienste, kein sudo, keine Firewall-Regeln.

​
Den Connector beim Booten starten

Der Installer startet den Connector im Vordergrund oder mit --detach / -Detach im Hintergrund. Keines überlebt einen Neustart. Um Ihr Modell nach einem Neustart erreichbar zu halten, führen Sie den Connector unter dem Dienstmanager Ihrer Plattform aus. Der Connector erlaubt 1 laufende Instanz pro Installationsverzeichnis, also stoppen Sie zuerst einen abgelösten Prozess:
~/.config/systemd/user/tokios-connector.service
Der Connector bewahrt sein Pairing in tokios-connector.json auf, sodass ein Dienststart nach einem Neustart sich ohne neuen Pairing-Code verbindet.