メインコンテンツへスキップ
Tokios コネクタは、モデルと同じマシンで実行する小型のコンソールアプリです。単一の WebSocket 経由で Tokios へ接続し、リクエストをローカルモデルに転送します。インバウンドポートもパブリック IP もファイアウォールの変更も不要です。 コンソールの Setup wizard から、一回限りの ペアリングコード でインストールおよびペアリングを行います。基本的なパスでは設定ファイルを手動編集することはありません。コネクタはデバイス承認後にトンネル経由でトークンを安全に受信します。

​
1. ペアリングコードを取得する

コンソールの Setup タブで Start pairing をクリックします（ステップ 1）。Tokios から TKS-XXXX-XXXX のようなペアリングコードが表示され、有効期間は約 15 分です。タブは開いたままにしてください。

​
2. コネクタをインストールして実行する

モデルと同じマシンで、コンソールに表示される OS 用のワンライナーを実行します。
Windows 10 および 11（x64）。PowerShell で:
すでに tokios-connector がインストール済みですか？インストーラーをスキップして、ペアリングコードを直接渡します。

​
3. デバイスを承認する

コネクタが接続し、コンソールに表示されます。Setup タブまたは Connectors タブで、デバイスを approve します。Tokios はトンネル経由でコネクタのトークンを配信します。トークンは画面に表示されたり、ファイルに貼り付けられたりすることはありません。
コネクタはアウトバウンド接続のみを行うため、ポートで待ち受けません。ファイアウォールにインバウンドルールを追加する必要はありません。
接続完了後、モデルを登録し、API キーを作成してください。

​
上級者向け: 設定ファイルで複数のモデルを公開する

単一の接続で複数のモデルを提供するには、単一モデルをペアリングする代わりに、各アップストリームを定義した JSON 設定でコネクタを実行します。Connector Config を参照してください。

​
インストーラーがマシンを変更する内容

  • インストールディレクトリ。 コネクタバイナリと tokios-connector.json は ~/.tokios/connector（macOS および Linux）または %LOCALAPPDATA%\Tokios\connector（Windows）に一緒に配置されます。別のフォルダーを指定するには --dir / -InstallDir を渡します。
  • PATH。 macOS および Linux では、インストーラーがバイナリへのシンボリックリンクを ~/.local/bin に作成し、そのフォルダーが PATH にない場合は # tokios-connector PATH というマークの付いた 1 行をシェルプロファイル（.zshrc、.bashrc、または .profile）に追加します。同じ行が二度追加されることはなく、実行内容が表示され、アンインストール時にも他のツールが同じフォルダーを使用している可能性があるため行は残ります。元に戻すには、その行を削除してください。Windows では、デフォルトのインストールフォルダーをユーザーの Path に追加します。tokios-install -Uninstall で削除されます。すべてスキップするには --no-path / -NoPath を渡します。
  • その他は何も変更しません。 システムサービスも、sudo も、ファイアウォールルールもありません。

​
起動時にコネクタを実行する

インストーラーはコネクタをフォアグラウンドで起動します。--detach / -Detach でバックグラウンド起動も可能です。いずれも再起動後は維持されません。再起動後もモデルを到達可能にするには、プラットフォームのサービスマネージャーでコネクタを実行します。コネクタはインストールディレクトリごとに 1 つの実行インスタンスのみ許可するため、先に切り離しプロセスを停止します。
~/.config/systemd/user/tokios-connector.service
コネクタはペアリング情報を tokios-connector.json に保持するため、再起動後のサービス開始時に新しいペアリングコードなしで再接続します。