Neat Library をインストールまたはアップデートしてください。

このページを使用して、Palette Neat Library をインストールまたは更新してください。

Neat SDK 内の Neat Library

sima-cli sdk setup の際に DevKit をペアリングすると、SDK は、DevKit 上の ~/pyneat に、同梱されている Neat Library とバンドルされた PyNeat 環境を自動的にインストールします。

インストール場所を選択してください

Neatアプリケーションをビルドまたは実行する環境から、インストーラーを実行してください。

環境	使用する場面
Neat SDK	新しい SDK バージョンをインストールせずに、Neat SDK 内の Neat Library をアップグレードしたい場合。
ROS2 SDK	コンテナのシステムパスにインストールされた Neat ヘッダーとライブラリを使用して、ARM64 上で ROS 2 アプリケーションをネイティブにコンパイルしたい場合。
DevKit	デバイスにランタイムを直接インストールまたは更新したい場合。

前提条件

Neat Library をインストールする予定の環境に、sima-cli をインストールしてください。 sima-cli のインストールガイド を使用してください。

community.sima.ai でアカウントを作成すると、テスト用の事前コンパイル済みモデルなど、SiMa.ai のアセットにアクセスできます。

環境を認証し、インストーラーが SiMa.ai のアーティファクトをダウンロードできるようにします。詳細については、sima-cli にログイン を参照してください。

sdk-or-devkit$sima-cli login

環境が SiMa.ai のアーティファクトが保存されているホストにアクセスできることを確認してください。

sdk-or-devkit$curl -fsS https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh -o /dev/null && echo "artifacts reachable"

「artifacts reachable」と表示される場合、ホストにアクセスできる状態です。タイムアウト、接続拒否、または「ホストを解決できません」などのcurlエラーは、外部へのアクセスがブロックされていることを意味します。ホストのネットワーク、プロキシ、またはファイアウォールを確認してください（Neat SDK ネットワーク機能およびホスト設定に関する注意事項を参照）。または、マシンがSiMa.aiサービスに直接アクセスできない場合は、オフラインでのインストールを使用してください。

Neat Library をインストールします。

パッケージの互換性

インストーラーは、選択されたコア・アーティファクトにリストされているすべての Debian パッケージを使用し、異なる Internals や LLiMa のバージョンは選択しません。インストールされたプラットフォームは、そのアーティファクトに含まれていない依存関係を満たす必要があります。APT がプラットフォーム・パッケージを削除してインストールを完了しようとした場合、インストーラーは停止します。コアまたは LLiMa でパッケージを置き換えるのではなく、プラットフォームを更新してください。

インストーラーを実行する前に、作業ディレクトリを選択してください。DevKitでは、ルートファイルシステムがいっぱいにならないように、/media/nvmeにインストールしてください。SDKコンテナー内では、$HOME/neatのようなコンテナーローカルのパスを使用してください。

環境を選択し、次に手順を順番に実行します。C++アプリケーションをクロスコンパイルするために、Neat SDKコンテナにインストールします。ARM64でネイティブにコンパイルするために、ROS2 SDKにインストールします。そのDebianパッケージは、Neatのクロスコンパイルsysrootではなく、**/usrにインストールされます。DevKitにインストールして、そこでランタイムをセットアップします。これにより、PyNeatも~/pyneat**にプロビジョニングされます。インストーラーコマンドは、どの環境でも同じです。

$HOME/neat のような、コンテナローカルのインストールディレクトリを準備してください。

username@neat-sdk-latest$cd $HOME && mkdir -p neat && cd neat

sima-cli で選択されたデフォルトの Neat Library パッケージをインストールします。必要に応じて、事前に作成されたチュートリアル、ソースコードのチュートリアル、およびテストなど、追加のパッケージをインストールすることもできます。

username@neat-sdk-latest$sima-cli neat install core@v0.4.0

デフォルトの PyNeat 環境

Neat Library を DevKit にインストールすると、~/pyneat 上の DevKit にデフォルトの PyNeat 仮想環境が設定されます。これがサポートされている PyNeat 環境です。直接アクティブにしてください。

modalix$source ~/pyneat/bin/activate

DevKit SyncとペアになったSDKコンテナ内でインストーラーを実行すると、インストーラーはSDKコンテナ内だけでなく、ペアになったDevKitにPyNeatをインストールします。PyNeatは、DevKit上の~/pyneatの下にある仮想環境にインストールされます。

カスタムの Python 仮想環境については、PyNeat をインストールしてください。 を参照してください。

ソースコードのビルド

まだリリースされていない変更を適用したい場合、カスタムビルド構成を作成したい場合、または Neat Library に貢献したい場合は、ソースコードからビルドしてください。ほとんどのユーザーは、上記の手順でパッケージをインストールする方が便利です。

もしソースコードからビルドしたい場合は、以下の構築するガイドに従ってください。

SDK のセットアップと DevKit Sync の初期設定については、Neat SDK を参照してください。

次のステップ

カスタムの Python 環境については、PyNeat をインストールしてください。 を参照してください。インストールされた環境を確認するには、Neat コマンドラインインターフェース を使用します。