Apple Silicon Macでnapari 0.9.1をインストールする方法：2026年の研究ガイド

公式の開発版インストール文書では、2026年9月4日時点でnapari 0.9.1が現在のコア版として案内されています。napari公式インストール文書にはApple Silicon向けconda-forge手順もありますが、独立macOSアプリの版はコアパッケージと異なる場合があります。今週は、画像の表示・注釈・書き出しだけなら独立アプリを先に検証し、Python、プラグイン、Jupyter、再現可能な課題環境が必要ならarm64のconda-forge環境を別に作る、という順番を推奨します。

対象は、画像をGUIで扱いたいもののPython環境には慣れていない研究生、napariを分割処理やJupyterへ組み込みたい研究者、研究室向けのプラグイン環境と遠隔Mac作業場所を整備する大学の技術担当者です。

※ 最終更新：2026年9月4日。コア版、Apple Silicon向け導入経路、Qtおよびプラグインの確認方法は、napari公式のインストール、リリース、プラグイン、レイヤー文書を基に再確認しています。公式の安定版、macOS arm64パッケージ、PythonまたはQtの対応範囲が更新された場合は、手順も再確認してください。

インストールで最初に決めるのは、アプリを起動できるかではなく、研究作業をどこまで再現する必要があるかです。独立アプリは導入作業を抑えやすい一方、利用するプラグインやPythonパッケージが同梱環境に対応しないことがあります。

ここでいうarm64は、Apple Silicon Mac上でIntel向け処理系を混在させないための確認です。アプリが開いたという一点だけでは、画像読み込み、プラグイン、書き出し、三次元操作が成功したとは判断できません。

napari公式のプラグイン依存関係に関する推奨事項でも、利用する依存関係と環境の扱いが重要になります。特定のプラグインが必要な場合は、先にプラグイン文書でnapariとPythonの対応範囲を確認してください。

Apple Silicon向けパッケージを選ぶ

公式リリースページからmacOS Apple Silicon向けの独立アプリを選び、ダウンロード後にアプリの情報画面でアーキテクチャと表示版を確認します。ここで表示される独立アプリ版を、コアパッケージのnapari 0.9.1と同一だと扱わないことが重要です。

コア版と独立アプリ版の関係は、次のように記録します。

最小の画像作業で合格判定を行う

公式サンプルを開いた後、脱識別済みの実験画像を1つ追加します。確認する順番は、画像レイヤーの表示、チャンネルやスケールの確認、簡単な注釈、保存と再読込です。napariの画像レイヤーと多尺度データの扱いは、napari公式の画像レイヤー文書に沿って確認できます。

次の項目をすべて満たせば、GUI利用の第一段階は合格です。

• [ ] Apple Silicon向けアプリを選んだ
• [ ] 独立アプリの表示版を記録した
• [ ] 公式サンプルを開いた
• [ ] 脱識別済みの代表画像を開いた
• [ ] 注釈を保存し、再読込できた
• [ ] 必要な形式へ書き出せた

注意：ウィンドウが開くことは起動確認にすぎません。ファイル形式、画像レイヤー、注釈、書き出しまで完了しない場合、研究用途の導入成功とは判定しないでください。

画像の表示と注釈だけが目的なら、ここでPython環境を追加しない方が管理しやすいです。反対に、必要なプラグインが独立アプリの環境へ導入できない場合は、依存関係を上から重ねず、次のarm64環境へ切り替えます。

Pythonスクリプト、Jupyter、処理パッケージを使う研究者は、既存のPython環境へnapariを追加しないでください。既存環境に別のQtや画像処理依存関係が入っていると、起動時だけでなくプラグイン読み込み時に問題が表面化するためです。

最小環境を作成する

ターミナルで、Apple Silicon上のarm64処理系を前提に、研究用環境を作成します。conda-forgeを用いたPython導入の考え方は、napari公式のPython・conda-forge導入説明で確認できます。

conda create -n napari091 -c conda-forge napari=0.9.1 pyqt6
conda activate napari091
napari

実際の依存関係解決で公式文書の指定が変わる場合は、公式手順を優先してください。PyQt6とPySide6を同一環境へ同時に追加するのではなく、課題で必要なバックエンドを一つ選び、環境定義に残します。

版、処理系、Qtの出所を確認する

起動後、次の情報を同じ環境から確認します。

python -c "import platform, napari; print(platform.machine()); print(napari.__version__)"
conda list napari
conda list pyqt
conda env export --no-builds > napari091-arm64.yml

表示された処理系がarm64であること、napariが意図した版であること、Qtパッケージが同じ環境にあることを記録します。コマンドの結果だけでなく、使用した環境名と作成日も研究室の記録へ残してください。

最小データでPython経路を検証する

まず公式サンプルまたは小さな配列を開き、次に代表的な顕微鏡画像へ進みます。最初から大容量の多次元データや複数プラグインを投入すると、Qtの問題、ファイル読み込みの問題、データ量の問題を切り分けられません。

合格条件は、napariの起動、画像レイヤーの作成、簡単な処理、保存、環境の再起動後の再現です。どれかが失敗した場合は、処理系を混在させる前に環境を書き出し、失敗したコマンドと表示されたエラーを記録します。

プラグインは、インストール済みと表示されても、メニューへ現れない、画像形式を認識しない、処理結果を書き出せないことがあります。原因をnapari本体だけに限定せず、対応版、Python範囲、Qt、プラグインのマニフェスト、外部依存関係の順に調べます。

導入前に依存関係を表にする

課題で使うプラグインごとに、次を記録してください。

• 対応するnapariの版
• 対応するPythonの範囲
• 推奨されるインストール元
• Qtバックエンドの指定
• 入力ファイル形式
• 出力形式
• GPUや外部コマンドの必要性
• 課題で実際に使う処理

プラグインのマニフェスト形式は、napari公式のプラグインマニフェスト仕様で確認します。プラグインが表示されない場合は、napari公式のプラグイン診断手順を使い、同じ環境から状態を取得してください。

代表ファイルで処理の最後まで確認する

テストは「プラグインが一覧に出る」で終わらせません。代表ファイルの読み込み、処理開始、結果の表示、結果の保存、napari再起動後の再利用まで確認します。

依存関係の解決によってnapariコア版を下げる必要が出た場合、またはIntel向けパッケージが混入した場合は、合格済みの環境を変更しないでください。プラグイン専用環境を作成し、課題の再現性を比較します。

MシリーズMacでは独立アプリとconda版のどちらを選ぶべきですか？

画像の表示、注釈、書き出しだけなら、公式Apple Silicon向け独立アプリを先に確認します。Pythonスクリプト、Jupyter、画像処理パッケージ、特定プラグインが必要なら、conda-forgeでarm64環境を分けます。独立アプリの版とコアパッケージの版は異なる場合があるため、両方を記録してください。

napariのプラグインを入れたのに機能が表示されないのはなぜですか？

インストール済みでも、対応するnapari版、Python範囲、Qtバックエンド、プラグインマニフェストの条件が合わない可能性があります。同じ環境から診断情報を取得し、プラグインが認識されているか確認してください。依存関係の変更で主環境を壊さず、問題のあるプラグイン用に別環境を作る判断も必要です。

Apple SiliconではPyQt6とPySide6のどちらを選ぶべきですか？

優先すべき基準は、利用するプラグインと研究室内で配布する環境がどちらを前提にしているかです。指定がない場合も、両方を同じ環境へ入れて解決を複雑にしないでください。一つのQtバックエンドを選び、napari起動、画像読み込み、プラグイン処理、書き出しを確認して固定します。

Macがなくてもnapariの顕微鏡画像解析を検証できますか？

Apple Siliconの実機へ接続できる遠隔環境を使えば、脱識別済みの代表画像と実際に使うプラグインを検証できます。確認範囲は起動だけにせず、読み込み、注釈、解析、書き出し、再起動後の再現性まで含めます。遠隔操作の遅延とMac上の処理性能は分けて記録してください。

大容量の顕微鏡画像、Zarr、Dask、多尺度データでは、ファイルが開くことと研究作業が安定することを分けて考えます。napariのレイヤー説明で対応するデータ構造を確認したうえで、次の三段階を実施します。

1. 読み込み：ファイルが開き、レイヤー情報と次元が正しく表示されるか確認します。
2. 必要時読み込み：全体を一度に読み込まず、代表的な切片や多尺度表示が意図どおり動くか確認します。
3. 操作：三次元移動、注釈、処理、書き出しを行い、研究上必要な操作が完了するか確認します。

記録には、読み込みログ、処理前後のメモリ状況、代表切片、書き出し結果を含めます。遠隔Macを使う場合、画面更新の遅延はnapariの描画性能そのものではありません。接続経路の遅延と、Mac上での処理時間を別々に記録してください。

安定して代表作業を完了できない場合は、データをさらに大きくする前に停止します。脱識別、縮小版、既存のLinux環境との分担などを検討し、単に待ち続ける運用へ移行しないことが重要です。

研究室で共有する場合、作成者のアカウントだけで動く環境は納品済みとはいえません。次の資料を一つのフォルダーへまとめます。

• napari091-arm64.ymlなどの環境定義
• napariコア版、独立アプリ版、Qtバックエンド
• プラグイン名、版、導入元、マニフェスト情報
• サンプルデータの出所と脱識別方法
• 起動方法と代表処理の手順
• 入力、処理、出力結果の照合記録
• 遠隔接続、ファイル持ち出し、作業終了後のデータ削除手順

新しい利用者がログインできるか、環境を再構築できるか、同じ画像を処理できるかを、作成者以外のアカウントで確認します。遠隔Macを研究室の既存Linux・Windows設備へ補完的に組み込む場合は、どの工程をMacへ残し、どの工程を既存設備へ戻すかを明文化してください。

Macを持たない研究室で短期間だけ互換性を確認する場合は、JEXCLOUDのMac利用案内から利用形態を確認し、実際の課題に必要な環境条件を整理します。日本国内からの利用条件を確認する場合は、日本向けMacレンタルの案内も候補になります。利用地域や接続条件が異なる場合は、申込み前に研究データの持ち出し方針と遠隔接続方法を確認してください。

研究期間が短く、必要なのが特定プラグインと代表画像の検証だけなら、物理Macを購入する前に期間を限定した遠隔環境で合否を出す方が、機器購入後の互換性問題を避けやすいです。一方、長期間の高負荷処理、物理ポート、研究室内での常時共有が必要なら、レンタルだけで完結させる判断は適しません。

実験室にMacがない状態で、既存のLinuxやWindows環境だけを使い続けると、macOS固有のプラグイン挙動を確認できず、担当者の個人端末に環境が偏り、再現確認のたびにデータ移動と設定作業が発生します。研究用Macを購入すると初期費用、保守、利用期間終了後の余剰機器という別の負担も残ります。

そのため、まずは課題周期に合う遠隔の実機macOS環境で、arm64、プラグイン、代表画像、大画像操作を本文の基準で検証する方法が現実的です。全項目に合格してから、継続レンタル、機器購入、既存設備との二重運用を選べば、推測だけで長期費用を固定せずに済みます。