Python 3.12 と依存ライブラリ¶
対象ユーザー
依存環境の構成を確認したい方や、内蔵の環境構築ツールを使用できない現場向けの説明です。通常はソフトウェアの「環境構築」機能を使用してください。
1. Python 3.12 をインストール¶
Python 3.12 系を推奨します。Ubuntu 24.04.4 LTS には Python 3.12 系が含まれるため、この手順を省略できます。
ダウンロード¶
Python 公式ダウンロード一覧から、3.12 系の Windows installer (64-bit) を選択します。Python 3.12.4 のインストーラーも利用できます。

インストールの要点¶
- ダウンロードした
.exeを実行します。 - 「Add Python.exe to PATH」を必ず有効にします。 無効のままだと端末で
pythonを直接実行できません。 - 「Install Now」、またはカスタムインストールを選択します。

終了画面に「Disable path length limit」が表示された場合は、有効にすることを推奨します。深い階層のモデルファイルなどでパス長の問題を避けられます。

動作確認¶
CMD または PowerShell で実行し、3.12.x と表示されることを確認します。
2. 主な依存ライブラリ¶
| ライブラリ | 用途 |
|---|---|
OpenCV (opencv-python) |
画像処理、カメラ |
Pillow (PIL) |
基本画像操作、形式変換 |
| NumPy | 行列演算、画像データ処理 |
| Scikit-learn | 評価、前処理 |
| Tqdm | 処理・学習の進捗表示 |
3. オンライン環境構築¶
サイドバーの「環境構築」を開きます。

- ミラーを選択します。既定は Huawei Cloud です。
- 各ライブラリのカードをクリックし、インストール完了を待ちます。
- 必要に応じて端末でバージョンを確認します。
4. オフライン環境構築¶
ネット接続のない現場では、事前に用意したパッケージを使用します。
- 「環境構築」で「オフラインインストール」を選択します。
- 同梱のオフラインパッケージフォルダーを指定します。

必要なファイルを選び、一括インストールします。
