Windows で Python・pip・git をインストールする

ailia SDK を使い始めるための開発環境を Windows 上に整える手順を解説します。

OS を選択: Windows ・ MacLinux

このガイドについて

ailia SDK を Python から使うには、Pythonpipgit の 3 つが必要です。このガイドでは、それぞれが何をするものなのかと、Windows 10 / 11 へのインストール手順を順番に説明します。すべて完了すると pip3 install ailia でサンプルを動かせるようになります。

所要時間の目安: 3 つあわせて 15〜20 分ほどです。インストール中にダウンロードが発生するため、インターネットに接続した状態で進めてください。

1. Python のインストール

Python 公式サイトからインストーラをダウンロードします。ailia SDK は Python 3.6 以降に対応しています(特に理由がなければ最新の安定版で問題ありません)。

  1. ブラウザで Python 公式ダウンロードページ を開きます。
  2. ページ上部にある大きな黄色い 「Download Python 3.x.x」 ボタンをクリックします。これで 64bit 版の Windows インストーラ(python-3.x.x-amd64.exe)がダウンロードされます。
  3. ダウンロードした .exe をダブルクリックして実行します。
  4. インストーラの最初の画面で、一番下にある 「Add python.exe to PATH」(または「Add Python to PATH」)に必ずチェックを入れます
  5. 「Install Now」をクリックしてインストールを完了します。
どれをダウンロードすればいい? ダウンロードページに複数の選択肢が並んでいて迷う場合は、次を目印にしてください。
重要: 「Add python.exe to PATH」のチェックを忘れると、コマンドプロンプトで pythonpip が「見つかりません」となります。チェックを入れ忘れた場合は、もう一度インストーラを実行して「Modify」から PATH を追加するか、アンインストール後にチェックを入れて再インストールしてください。

インストールの確認

Windows のスタートメニューから「コマンド プロンプト」を開き、次のコマンドを入力して Enter キーを押します。

python --version

次のようにバージョンが表示されればインストール成功です(数字は環境によって異なります)。

Python 3.13.1
補足: Windows では python と入力すると Microsoft Store のページが開いてしまうことがあります。その場合は、上記の手順で python.org からインストールし直すか、py --version を試してください。

2. pip の確認とアップデート

pip は Python に同梱されているため、Python をインストールすれば別途インストールする必要はありません。まず使えることを確認します。

pip3 --version

バージョンが表示されれば利用可能です。古いままだとインストールに失敗することがあるため、最新版に更新しておくことをおすすめします。

pip3 install --upgrade pip
補足: pip3 コマンドが「見つかりません」と表示される場合は、pip3 の代わりに python -m pip に置き換えて実行してください(例: python -m pip --version)。こちらは python コマンドと同じ Python に対して確実に pip を実行できます。

3. git のインストール

サンプル集(ailia-models)を GitHub から取得するために git をインストールします。

  1. ブラウザで Git for Windows ダウンロードページ を開きます。
  2. 「Git for Windows/x64 Setup」をクリックしてインストーラをダウンロードします。
  3. ダウンロードした .exe を実行します。
  4. インストール中はオプションが多数表示されますが、すべて初期設定(デフォルト)のまま「Next」を押し続けて問題ありません。最後に「Install」をクリックします。

インストールの確認

インストール後、新しくコマンドプロンプトを開き直してから次のコマンドを実行します。

git --version

次のようにバージョンが表示されれば成功です。

git version 2.47.1.windows.1
補足: インストール直後に開いていたコマンドプロンプトでは git が認識されないことがあります。一度ウィンドウを閉じて開き直すと反映されます。

4. Visual C++ 再頒布可能パッケージのインストール

ailia SDK の本体は C/C++ で書かれたネイティブライブラリです。これを Windows 上で動かすには、Microsoft の Visual C++ 再頒布可能パッケージ(VC++ Redistributable)が必要です。インストールされていないと、import ailia の際に DLL の読み込みエラーが発生することがあります。

  1. 次のリンクから 64bit 版インストーラ(vc_redist.x64.exe)をダウンロードします。
    https://aka.ms/vc14/vc_redist.x64.exe
  2. ダウンロードした vc_redist.x64.exe を実行し、画面の指示に従ってインストールします。
  3. インストール後、PC の再起動を求められた場合は再起動してください。

最新の対応バージョンや、他のアーキテクチャ(x86 / Arm64)向けのインストーラは、Microsoft の公式ページで確認できます。

サポートされている最新の Visual C++ 再頒布可能パッケージのダウンロード(Microsoft Learn)

補足: 他のアプリケーションを通じて既に VC++ 再頒布可能パッケージがインストールされている場合は、インストーラが「既にインストールされています」と表示します。その場合はそのまま閉じて問題ありません。

5. ailia SDK をインストールして動かす

Python・pip・git が揃ったら、いよいよ ailia SDK をインストールします。コマンドプロンプトで次を実行します。

pip3 install ailia

続いて、サンプル集をクローンして実行してみましょう。

git clone https://github.com/ailia-ai/ailia-models.git
cd ailia-models
pip3 install -r requirements.txt
cd object_detection/yolox
python yolox.py -v 0

Web カメラの映像に物体検出の結果が重ねて表示されれば成功です。詳しい使い方は ailia SDK のはじめに を参照してください。

次のステップ: GPU で高速に動かしたい場合は、NVIDIA GPU 向けの CUDA Toolkit / cuDNN インストールガイド や、クロスプラットフォームの Vulkan セットアップガイド もあわせて参照してください。