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

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

Palette SDK 内の Neat Library

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

オフラインでのインストールが必要な場合

対象が SiMa.ai サービスからパッケージをダウンロードできない場合は、オフラインでのインストールを使用してください。 インターネットに接続されたコンピューターでパッケージをダウンロードしてください。

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

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

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

C++ 開発パッケージ

最小インストールにはランタイムと sima-neat-dev が含まれます。デフォルトのインストールではチュートリアルとテストを追加オプションとして選択でき、all ではそれらも含まれます。共有ライブラリアプリケーションには、Core の公開ヘッダー、対応する Scheduler フロントエンド、および GStreamer、OpenCV、JSON の開発ファイルが必要です。廃止された Internals 統合パッケージや、Runner、Kernels、Codecs、メモリライブラリ、ヒープ、LLiMa の開発 API は不要です。選択したパッケージが必要なランタイム依存関係を提供します。

インストール済みの共有ターゲットを使用します。

find_package(SimaNeat CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE SimaNeat::sima_neat)

静的アーカイブは引き続き sima-neat-dev に含まれます。COMPONENTS Static を使い、対応する simaai-scheduler パッケージをインストールしたままにしてください。zlib1g-dev、libcpp-httplib-dev、LLiMa 有効ビルドの場合は sima-lmm-dev を、それぞれの依存関係とともに用意します。Core はインストール済み Scheduler フロントエンドを使用します。アプリケーションに Internals や下位ライブラリの開発ターゲットを追加しないでください。

find_package(SimaNeat CONFIG REQUIRED COMPONENTS Static)
target_link_libraries(my_app PRIVATE SimaNeat::sima_neat_static)

静的 Core も共有実装ライブラリを使用します。Core をソースからビルドする場合も同じ Scheduler フロントエンド境界を使い、ほかの依存関係の開発ファイルが必要です。LLiMa が有効な場合は、その開発ファイルも含まれます。

オンラインインストールの前提条件

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エラーは、外部へのアクセスがブロックされていることを意味します。ホストのネットワーク、プロキシ、またはファイアウォールを確認してください（Palette SDK ネットワーク機能およびホスト設定に関する注意事項を参照）。または、マシンがSiMa.aiサービスに直接アクセスできない場合は、オフラインでのインストールを使用してください。

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

パッケージ互換性

インストーラーは選択した Core アーティファクトに記載された Debian パッケージをすべて使用し、別の Scheduler または LLiMa バージョンを選びません。そのアーティファクトで配布されない依存関係は、インストール済みプラットフォームが満たす必要があります。インストール完了のために APT がプラットフォームパッケージを削除しようとする場合、インストーラーは停止します。Core や LLiMa 内でパッケージを差し替えず、プラットフォームを更新してください。

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

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

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

sdk$cd $HOME && mkdir -p neat && cd neat

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

sdk$sima-cli neat install core@v0.6.1

オンラインインストールのデフォルト PyNeat 環境

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

devkit$source ~/pyneat/bin/activate

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

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

ソースコードのビルド

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

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

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

オフラインでのインストール

インストール前に Python の依存関係を確認する

オフラインインストールでは、既存の Python 環境と追加のパッケージやファイルを保持します。パッケージのインストール前に pip check を実行し、環境がすでに壊れている場合は停止して、環境のパスと依存関係のエラーを表示します。報告された依存関係を修復してから再試行してください。オフラインで修復する場合は、追加の wheel ファイルが必要です。インストール後にも依存関係を確認し、残っている競合や新たに生じた競合を報告します。パッケージの変更は自動的には元に戻されません。

環境を破棄して新規にインストールする場合に限り、明示的に ./install.sh --recreate-venv（単体 Core）または sudo python3 -B install.py --recreate-venv（PCIe）を実行してください。選択された環境内のパッケージとファイルは、バックアップなしで削除されます。SDK では、このオプションはペアリングした DevKit に適用され、SDK ホストの Python には適用されません。必要なファイルを事前に保存してください。事前確認と検証のみのコマンドでは、環境を再作成しません。

Neat Library オフラインパッケージは、バージョン 0.6.0 以降で利用できます。 Platform 3.0 以降を使用する Modalix DevKit には、このパッケージを使用してください。

1. パッケージをダウンロードする

インターネットに接続されたコンピューターに sima-cli をインストールしてください。sima-cli インストールガイドを参照してください。

インターネットに接続されたコンピューターで、次のコマンドを実行してください：

host$sima-cli neat install core/offline@v0.6.1 --download-only

既定のパッケージには、ランタイム、チュートリアル、テストが含まれます。 ランタイムのみをダウンロードするには、次を使用してください：

host$sima-cli neat install core/offline@v0.6.1 -t minimal --download-only

2. パッケージをインストールする

1. ダウンロードしたファイルを Modalix DevKit または Palette SDK ワークスペースにコピーしてください。
2. そのディレクトリでターミナルを開いてください。SDK にインストールする場合は、SDK シェルを使用してください。
3. インストーラーのアーカイブを展開してください：

ダウンロードしたアーカイブ名には .tar.gz の前に SHA-256 の先頭 8 文字が付く場合があります。展開前に、このディレクトリには選択したインストーラーアーカイブだけを置いてください。

sdk or devkit$tar -xzf neat-core-offline-installer*.tar.gz

4. 展開したディレクトリに移動してください：

sdk or devkit$cd neat-core-offline

5. 通常ユーザーとしてインストーラーを起動してください。必要に応じて sudo 権限を要求します。

sdk or devkit$./install.sh

チュートリアルやテストが必要な場合は、別の追加アーカイブを任意のディレクトリに展開してください。

オフラインでのインストール後、次のコマンドで Python 環境を有効にしてください：

devkit$source ~/pyneat/bin/activate

オフラインインストールでは、ホストの既存の ~/pyneatpcie、またはカードや DevKit の既存の ~/pyneat を再利用します。シンボリックリンクの場合はリンク先を再利用します。ホームに環境がない場合、カードや DevKit は、インストールするユーザーが NVMe に書き込めるときは /media/nvme/pyneat、それ以外は ~/pyneat を使用します。新しい NVMe インストールでは、既存のホーム環境を置き換えずに ~/pyneat リンクを作成します。

パッケージオプションとインストーラーの動作

• インストーラーは、インストール前にシステムの互換性とディスクの空き容量を確認します。
• インストーラーは同梱の依存パッケージを使用します。必要な依存パッケージがない場合は停止します。
• SDK では、Neat Library を /opt/toolchain/aarch64/modalix にコピーします。
• DEVKIT_SYNC_DEVKIT_IP が設定されている場合は、SSH 経由でペアリング済みの DevKit にもインストールします。両方の環境がチェックに合格する必要があります。

インストールに失敗した場合は、表示されたパスのログを読んでください：/tmp/neat-core-offline-*.log。 詳細な出力には、./install.sh --verbose を使用してください。

インストール中に SSH が切断されても、リモートのインストーラーは動作を続ける場合があります。 再試行する前、またはレポートに表示された一時ディレクトリを削除する前に、インストーラーが停止したことを確認してください。

次のステップ

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