Passer au contenu principal
Le connecteur Tokios est une petite application console que vous lancez sur la machine voisine de votre modèle. Il se connecte à Tokios via un unique WebSocket et transmet les requêtes à votre modèle local — aucun port entrant, aucune IP publique, aucune modification du pare-feu. Vous l’installez et l’appairez depuis la console avec le Setup wizard à l’aide d’un code d’appairage à usage unique. Pour le chemin de base, vous n’éditez pas manuellement un fichier de configuration — le connecteur reçoit son jeton de manière sécurisée via le tunnel après que vous avez approuvé l’appareil.

​
1. Obtenir un code d’appairage

Dans l’onglet Setup de la console, cliquez sur Start pairing (étape 1). Tokios affiche un code d’appairage comme TKS-XXXX-XXXX, valable environ 15 minutes. Gardez l’onglet ouvert.

​
2. Installer et lancer le connecteur

Sur la machine voisine de votre modèle, exécutez la commande en une ligne que la console affiche pour votre système d’exploitation.
Windows 10 & 11 (x64). Dans PowerShell :
Vous avez déjà tokios-connector installé ? Passez l’installateur et passez le code d’appairage directement :

​
3. Approuver l’appareil

Le connecteur se connecte et apparaît dans la console. Dans l’onglet Setup (ou l’onglet Connectors), approve l’appareil. Tokios délivre alors le jeton du connecteur via le tunnel — il n’est jamais affiché à l’écran ni collé dans un fichier.
Le connecteur ne fait que se connecter ; il n’écoute jamais sur un port, donc votre pare-feu n’a besoin d’aucune règle entrante.
Une fois connecté, enregistrez votre modèle et créez une clé API.

​
Avancé : exposer plusieurs modèles avec un fichier de configuration

Pour servir plusieurs modèles via un seul connecteur, lancez le connecteur avec une configuration JSON qui définit chaque upstream au lieu d’appairer un seul modèle. Consultez Connector Config.

​
Ce que l’installateur modifie sur votre machine

  • Répertoire d’installation. Le binaire du connecteur et son tokios-connector.json se trouvent ensemble dans ~/.tokios/connector (macOS et Linux) ou %LOCALAPPDATA%\Tokios\connector (Windows). Passez --dir / -InstallDir pour choisir un autre dossier.
  • PATH. Sur macOS et Linux, l’installateur crée un lien symbolique du binaire dans ~/.local/bin et, si ce dossier n’est pas dans votre PATH, ajoute 1 ligne marquée # tokios-connector PATH à votre profil shell (.zshrc, .bashrc, ou .profile). Il n’ajoute jamais la ligne deux fois, affiche ce qu’il a fait, et la ligne reste à la désinstallation car d’autres outils peuvent utiliser le même dossier. Pour annuler, supprimez cette ligne. Sur Windows, il ajoute le dossier d’installation par défaut à votre Path utilisateur ; tokios-install -Uninstall le retire. Passez --no-path / -NoPath pour sauter tout cela.
  • Rien d’autre. Aucun service système, pas de sudo, aucune règle de pare-feu.

​
Lancer le connecteur au démarrage

L’installateur démarre le connecteur au premier plan, ou en arrière-plan avec --detach / -Detach. Aucun ne survit à un redémarrage. Pour garder votre modèle accessible après un redémarrage, lancez le connecteur sous le gestionnaire de services de votre plateforme. Le connecteur autorise 1 instance en cours d’exécution par répertoire d’installation, donc arrêtez d’abord un processus détaché :
~/.config/systemd/user/tokios-connector.service
Le connecteur conserve son appairage dans tokios-connector.json, donc un démarrage de service après un redémarrage se reconnecte sans nouveau code d’appairage.