メインコンテンツまでスキップ

SDK のインストール

最新のPalette SDKをインストールします。Palette SDKはホストマシン上でコンテナとして動作します。

前提条件​

後でDevKit Syncを使用するには、次の項目も必要です。

  • Palette SDKと互換性のあるソフトウェアを実行するDevKit。詳しくは互換性ガイドを参照してください。
  • NFSトラフィックが許可された同一ネットワーク上のホストマシンとDevKit。
  • DevKitのIPアドレス。

インストール​

現在のPalette SDK 3.0リリースチャネルをインストールします。

host$sima-cli neat install sdk@release-3.0

初回インストールではPalette SDKコンテナイメージをダウンロードするため、数分かかることがあります。ダウンロード後、インストーラーがSDKのセットアップを開始し、Modalix DevKitとペアリングするか、対応するModel CompilerをSDK内にインストールするかを確認します。

DevKitとのペアリングを選んだ場合は、表示されたプロンプトにDevKitのIPアドレスを入力します。セットアップ処理はSDKワークスペースを構成し、SDKコンテナを起動してDevKit Syncを設定します。ペアリングを省略してもSDKワークスペースは作成され、後からペアリングできます。

release-3.0パッケージは、3.0系の最新Palette SDKパッチリリースを追跡します。現在のリリースはPalette SDK 3.0.0.1で、DevKitソフトウェア3.0.0と互換性があります。

セットアップ中、sima-cliは対応するModel CompilerをSDK内にインストールするか確認します。モデルを自分でコンパイルまたは量子化する場合は承認してください。別のバージョンを選択する必要はありません。コンパイル済みモデルパッケージだけを実行する場合は省略できます。後からインストールする場合、特定のパッチを固定する場合、またはスタンドアロンホストを使用する場合は、Model Compilerのインストールと互換性ガイドを参照してください。

特定の SDK バージョンをインストールする​

SDK 2.1.3.0 以降では、公開済みの v<version> タグを使用して、以前のパッチリリースを含む特定のバージョンをインストールできます。たとえば、ホストで次のコマンドを実行します。

host$sima-cli neat install sdk@v2.1.3.0

v プレフィックスは必須です。特定のバージョンタグに release-<full-version> を使用しないでください。release-<series> チャネルは、そのシリーズの最新の公開リリースを追跡します。同じ SDK パッケージを選択する場合、どちらも同じインストールおよび SDK セットアップ手順を実行します。

公開済みのタグは SDK リリース で確認し、互換性ガイド に従って DevKit ソフトウェアと互換性のあるバージョンを選択してください。

従来の2段階インストール

SDK 2.0.0、2.1.2.0、2.1.2.1 では、イメージの取得とセットアップに個別のコマンドが必要です。これらのリリースに限り、2段階SDKインストールを参照してください。

インストール後にSDK設定を変更するには、SDKの構成を参照してください。制限されたネットワーク環境では、オフラインインストールを参照してください。

SDKへのアクセス​

セットアップが成功すると、ターミナル、Chromeブラウザ、またはVS CodeからSDKにアクセスできます。

SDKシェルを使用する​

次のコマンドでPalette SDKシェルを開きます。

host$sima-cli sdk neat

Chromeブラウザを使用する​

Neat InsightはSDK内から提供され、ブラウザで開くことができます。SDKシェル内で次を実行します。

sdk$neat

neat の出力の Web Access セクションには、Insight とブラウザ版 VS Code のローカルおよびリモート URL が表示されます。SDK ホストでブラウザを使用する場合は、ローカルの 127.0.0.1 URL を開いてください。別のコンピューターからは、NFS_SERVER_HOST_IP に基づくリモート URL を使用します。VS Code の URL は設定済みワークスペースを開きます。インストールされているサーバーに対して neat が表示する認証情報を使用してください。SDK の Web アクセスと Insightを参照してください。

VS Codeを使用する​

SDK シェル内で neat を実行し、SDK ホストのブラウザで VS Code (local) の URL を開いてください。別のコンピューターからは VS Code (remote) を使用します。code-server を含むイメージでは、neat が VS Code password も表示します。

VS Code (local)    https://127.0.0.1:10000/?folder=/workspace
VS Code password   <password shown by neat>

code-server のサインイン画面で、表示されたパスワードを入力してください。パスワードは URL には含まれません。

従来の OpenVSCode イメージでは、代わりにトークン付き URL を使用します。neat が表示する URL を開いてください。SDK には、ブラウザ版 Code UI 用の Codex と Claude Code の拡張機能がプリインストールされています。

ブラウザ版ではなくネイティブVS Codeも利用できます。Dev Containersを使用して、VS CodeをSDKコンテナへ接続してください。

コンパイル済みモデルなどのアセットをSDKが取得できるよう、SDKコンテナ内でsima-cli loginを一度実行します。

アップグレード​

現在のSDKパッケージを再インストールまたはアップグレードするには、ホストから上記のインストールコマンドを再実行します。

host$sima-cli neat install sdk@release-3.0

既存のPalette SDKコンテナ内にあるNeatライブラリを更新するには、コンテナシェルからNeat CLIを実行します。

sdk$neat update

このコマンドは、現在のPalette SDKにインストールされているNeatライブラリのコンポーネントを更新します。コンテナレベルの変更が必要な場合に、コンテナイメージ全体のアップグレードを置き換えるものではありません。

後でPalette SDKコンテナを削除または再作成した場合は、新しいコンテナ内でもう一度neat updateを実行してください。

アンインストール​

インストール済みSDKコンテナを削除するには、次を実行します。

host$sima-cli sdk remove

次のステップ​

  • SDK内でモデルをコンパイルしますか？ DevKitを必要とせずSDK内だけで実行できるモデルのコンパイルに進みます。
  • DevKitをペアリングしますか？ SDKワークスペースを共有し、ハードウェアでdkコマンドを実行するためにDevKit Syncを設定します。