メインコンテンツへスキップ
DGX Spark上ではすでにモデルが問題なく稼働しています。難しいのは、サーバーをインターネットに公開したりゲートウェイを自前で構築したりせずに他の場所からそのモデルを利用することです。Tokiosのコネクターをランタイムの隣で実行すれば、https://api.tokios.comという場所に認証付きのエンドポイントが生成され、OpenAIおよびAnthropic双方のリクエスト形式に対応します。これにより、ファイアウォールの設定をいじる必要もなく、ご自身のノートパソコンやClaude Code、招待した他のユーザーもSparkにアクセスできるようになります。
Sparkをすぐに接続したいですか? コネクターの設定手順を知りたい場合は クイックスタート へ進んでください。すでにランタイムが稼働している場合は モデルの登録 へお進みください。

「it runs」の後の空白部分

DGX SparkやGB10のユーザーは通常、Ollamaやllama.cpp、vLLM、Lemonade Serverを使ってモデルを動作させますが、次の課題としてSpark本体以外の場所からそのモデルを利用したいという要望が生じます。
  • 仕組みの構築。 複数のモデルが存在する環境からOpenAI互換のエンドポイントをひとつ作るには、LiteLLMやllama-swap、ランタイム自体を連携させ、同期を維持するためのポーリングデーモンも用意する必要があります。これらはDGX Sparkコミュニティのプロジェクトでも明確な目標として挙げられていますが、実際には「仕組みの構築」と呼ばれ、できるだけ避けたい作業でもあります。
  • リモートアクセス。 他のマシンからSparkにアクセスするための一般的な方法としては、ランタイムを0.0.0.0(snap set ollama host="0.0.0.0:11434")にバインドしたり、SSHトンネルやTailscaleを利用したりしますが、いずれもARM64やDGX OS上での設定が煩雑です。また、単純にポートを開放しただけではクライアントごとの認証機能も備わっていません。
  • APIの形式。 Claude CodeはAnthropicのMessages形式を使用し、ローカルのランタイムはOpenAIのChat Completions形式を使います。この二つをつなぐには、小さなプロキシを自作し維持していく必要があります。
Tokiosは既存のランタイムの上に配置される接続レイヤーです。Ollamaやllama.cpp、vLLM、Lemonade Serverを置き換えるものではありません。
2のDGX Spark群はDeepSeek-V4-Flash-0731を分割して運用するのに十分な総メモリ量を備えていますが、DeepSeek専用のクラスター構成は依然としてコミュニティによる検証段階にあり、0731の再検証も必要です。コネクターはヘッドノードの/v1エンドポイント上で稼働させてください。成熟度のラベルや設定の範囲については DeepSeek V4 Flashのローカルハードウェア をご参照ください。

DGX SparkクラスターでKimi K3を実行することは可能か?

いいえ。Kimi K3の2.8Tパラメータ(MoE経由でトークンあたり約50Bがアクティブ)は約1.4 TBをネイティブの4-bitフロアで必要とし、NVIDIAが公開しているSparkクラスターは最大4ノードで512 GBが上限であり、MoonshotはK3を64基以上のアクセラレーターを搭載したスーパーノードを対象としている。8台のDGX Spark(1 TBプール)でも、生のウェイトフロアだけで376 GB不足する。 現在のSpark環境においては、NVIDIAが公開している 120B シングルノード、400B ツーノード、または 700B フォーノード構成の範囲内からモデルを選択してください。DGX Sparkモデル互換性ページに全リストが記載されていますし、各Spark構成に最適なモデルを知りたい場合は Kimi K3の代替として実行すべきモデルもご覧ください。K3のメモリ計算方法やクラスターの仕様については、Kimi K3のハードウェア詳細解説を参照してください。

Spark環境上でセットアップを行う

1

Spark上でランタイムを起動する

通常通りモデルサーバーを実行してください。例えば以下のように:
または
Lemonade ServerはCUDAを自動的に処理する代替手段である — DGX SparkのGPUを検出し、手動フラグなしで適切なバックエンドを選択する。
Lemonade Serverはデフォルトでポート13305でリッスンし、/v1にOpenAI互換APIを公開する。インストール手順は lemonade-server.ai を参照してください。コネクターを追加する前に、OpenAI互換の/v1 APIで正常に応答することを確認すること。
2

ペアリングコードを取得し、コネクタとペアリングする

TokiosのdashboardでSetupタブを開き、Start pairingを選択して、TKS-XXXX-XXXX形式のワンタイムペアリングコードを取得する(有効期限は約15分)。Spark上で以下を実行する:
TokiosではLinux arm64向けのtokios-connectorビルドも提供されており、DGX Sparkに搭載されているGrace CPUにも対応しています。具体的なsystemd連携やパッケージ化手順はDGX OSのバージョンによって異なるため、インストールスクリプトを作成する前にご自身の環境を確認してください。ダッシュボードに戻り、SetupまたはConnectorsタブで該当デバイスを承認します。コネクター用のトークンは安全なトンネル経由で送信されるため、ユーザーがファイルに手動で入力する必要はありません。
3

コネクターをご利用中のランタイムの /v1 エンドポイントに向けてください

コネクターのアップストリーム先は、外部に公開したポートではなく、Spark上にあるランタイム自身のOpenAI互換APIです。既定のポート: Ollama 11434、vLLM 8000、Lemonade Server 13305(すべて末尾に /v1 を付加)。インバウンド用のファイアウォールルールは不要で、コネクターは送信通信のみ行います。
4

デプロイを登録する

ダッシュボードのModelsタブで、アップストリームのモデルID(例:llama3.1)をspark-llamaのような公開デプロイメント名にマッピングする。クライアントはアップストリームIDではなくこのデプロイメント名をmodelフィールドで送信する。
5

APIキーを作成する

ダッシュボードのKeysタブでキーを作成する。キーはsk-tok-…形式のBearerトークンで、一度だけ表示され、特定のデプロイメント名パターンにスコープを設定できる。

どこからでも利用可能

コネクターのペアリングとデプロイ登録が完了すれば、クライアント側はSparkのIPアドレスではなくTokiosを指定すればよくなります。
Claude Codeのモデル選択画面には claude* 形式のIDのみが表示されるため、Tokios上のデプロイはリストに現れません。その場合は --model spark-llama を明示的に指定してください。
Spark上で複数のモデルを運用したり、Ollama、llama.cpp、vLLM、Lemonade Server間でトラフィックを分散させたい場合は、単一アップストリーム用の手順ではなく コネクター設定ファイル を用いて複数のルートやアップストリーム先を定義します。同一エンドポイント下で複数のデプロイを登録・切り替える方法については モデルルーティング をご覧ください。

なぜエンドポイントが一つだけなのか

  • クライアント側の設定変更なしにモデルを切り替え。 デプロイ名を別のアップストリームモデルやバックエンドに紐付け直しても、既に spark-llama を利用しているエージェントやスクリプトはそのまま動作し続けます。
  • チームメイト向けのスコープ付きキー。 チームメイトにSparkへの全権限を与える代わりに、特定のデプロイパターンに限定されたキーを付与できます。
  • Spark側に受信用ポートは不要。 コネクターは送信接続のみ行うため、ラップトップからアクセスするためにランタイムを0.0.0.0に紐付けたり、SSHトンネルやTailscaleノードを維持したりする必要はありません。

次に行うべきこと

クイックスタート

ゼロからコネクター、デプロイ、そしてAPIキーを設定して稼働させるまでの手順です。

コネクターのインストール

各プラットフォーム向けのコネクターの完全なインストールおよびペアリング手順を記載しています。

Claude Codeの利用法

設定方法:ANTHROPIC_BASE_URLおよびANTHROPIC_API_KEYの詳細。

コネクター設定のリファレンス

複数モデルの配信:tokios-connector.jsonでSparkから。