OpenPose 1.7.0 のインストール,デモの実行(Windows 上)
URL: https://github.com/CMU-Perceptual-Computing-Lab/openpose
ライセンス: 「ACADEMIC OR NON-PROFIT ORGANIZATION NONCOMMERCIAL RESEARCH USE ONLY」 https://github.com/CMU-Perceptual-Computing-Lab/openpose/blob/master/LICENSE のように定められているので,利用者側で確認すること.
このページでは,Windows での,OpenPose のインストール手順をスクリーンショット等で説明する.
【サイト内の関連ページ】
謝辞:このWebページで紹介する OpenPose ソフトウェアの作者に感謝します
前準備
Build Tools for Visual Studio 2026(ビルドツール)のインストール
Build Tools for Visual Studio 2026(ビルドツール)のインストールを行い、C/C++ コードのビルド環境を整える。
Build Tools for Visual Studio は,Visual Studio の IDE を含まない C/C++ コンパイラ,ライブラリ,ビルドツール等のコマンドライン向け開発ツールセットである。インストール済みの場合,この手順は不要である。 以下のコマンドは、Build Tools が未インストールの場合は winget で新規インストールし、インストール済みの場合は 【インストールコマンドの実行方法】 管理者権限でコマンドプロンプトを起動する(手順:Windows キーまたはスタートメニュー → 上記のコマンドでは、Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし、続いて以下のコンポーネントを追加している。 上記以外の追加のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。 インストール完了の確認 Visual Studio を必要とするとき Visual Studio の機能を必要とする場合は,追加インストールできる。 以下のいずれかの方法で Python 3.7 をインストールする。Python がインストール済みの場合、この手順は不要である。 方法1:winget によるインストール 管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「 方法2:インストーラーによるインストール インストールの確認 コマンドプロンプトで以下を実行する。 バージョン番号(例:[Build Tools for Visual Studio 2026(ビルドツール)のインストール手順を見るには、ここをクリック]
Windows での Build Tools for Visual Studio 2026 のインストール
setup.exe modify でコンポーネントを追加する(バージョンは変更しない)。cmd と入力 → 右クリック → 「管理者として実行」)。そして、コマンド全体をコマンドプロンプトにコピー&ペーストする。REM VC++ ランタイム
winget install --scope machine --id Microsoft.VCRedist.2015+.x64 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet /norestart"
REM ============================================================
REM Visual Studio Build Tools + Desktop development with C++
REM (VCTools、MSBuildTools、CMake連携、Clang、Windows 11 SDK)
REM ============================================================
REM 進行中のインストーラーを停止(ロック競合回避)
taskkill /F /IM vs_setup.exe /T >nul 2>&1
taskkill /F /IM vs_installer.exe /T >nul 2>&1
taskkill /F /IM vs_installerservice.exe /T >nul 2>&1
REM 未インストール時: winget で新規インストール
REM インストール済み時: setup.exe modify でコンポーネント追加(バージョンは変更しない)
winget list --id Microsoft.VisualStudio.BuildTools 2>nul | findstr /i "BuildTools" >nul 2>&1
if %ERRORLEVEL% EQU 0 (
for /f "usebackq delims=" %P in (`"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -products Microsoft.VisualStudio.Product.BuildTools -property installationPath`) do start /wait "" "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "%P" --add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --includeRecommended --quiet --norestart --nocache
) else (
winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100"
)
REM 破損時の修復(任意、動作がおかしくなった場合)
REM "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" repair --installPath "C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools" --quiet --norestart
REM 導入確認(インストールパスが表示されれば正常)
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -products * -requires Microsoft.VisualStudio.Workload.VCTools -property installationPath
--includeRecommended により、MSVC コンパイラ、C++ AddressSanitizer、vcpkg、CMake ツール、Windows 11 SDK 等の推奨コンポーネントが含まれる)winget list Microsoft.VisualStudio.BuildToolsPython 3.7 のインストール(Windows 上) [クリックして展開]
cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。winget install -e --id Python.Python.3.7 --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 AssociateFiles=1 InstallLauncherAllUsers=1"--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。
python コマンドを実行できない。python --versionPython 3.7.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。
NVIDIA CUDA Toolkit 12.8のインストール
- 前提条件(NVIDIA CUDA Toolkit インストール前): NVIDIA GPU,NVIDIA ドライバ,および Build Tools for Visual Studio もしくは Visual Studio が必要である.
- インストール中の注意: なるべく他のウインドウはすべて閉じておくこと.
以下のコマンドを管理者権限のコマンドプロンプトで実行する
(手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。
REM NVIDIA CUDA Toolkit 12.8 をシステム領域にインストール
winget install --scope machine --id Nvidia.CUDA --version 12.8 -e --silent --disable-interactivity --force --uninstall-previous --accept-source-agreements --accept-package-agreements --override "-s -n"
REM 環境変数TEMP, TMPの設定(一時ファイルの保存先を短いパスに変更)
mkdir C:\TEMP
set "TEMP_PATH=C:\TEMP"
setx TEMP "%TEMP_PATH%" /M >nul
setx TMP "%TEMP_PATH%" /M >nul
OpenPose 1.7.0 のインストール
- Web ブラウザで、OpenPose のリリース(release)のWebページを開く
https://github.com/CMU-Perceptual-Computing-Lab/openpose/releases
- ファイルを選ぶ
「Assets」が展開されていないときは展開する.
Windows 版が公開されているもののうち、最新のものを選ぶことにする. CPU版,GPU版を選ぶことができる
- ZIP ファイルのダウンロードが始まる
- ダウンロードした .zip ファイルを、 C:\ の直下に 展開(解凍)するなど,分かりやすいディレクトリに置く.
- 展開(解凍)により,ディレクトリができるので確認する
GPU 版の場合:openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended のような名前
CPU 版の場合:openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d のような名前
- できたディレクトリを,C:\ の直下にコピーする.
次のようになる(次の図は GPU 版の場合)
- Windows の システム環境変数 Pathに,追加することにより,パスを通す.
-
GPU 版の場合:C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended\openpose\bin を追加
Windows で,管理者権限でコマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー >
cmdと入力 > 右クリック > 「管理者として実行」)。次のコマンドを実行
powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended\openpose\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
-
CPU 版の場合:C:\openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d\openpose\bin を追加
Windows で,管理者権限でコマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー >
cmdと入力 > 右クリック > 「管理者として実行」)。次のコマンドを実行
powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";C:\openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d\openpose\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
-
GPU 版の場合:C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended\openpose\bin を追加
- modelsの下の
getBaseModels.bat を実行する
モデルデータがダウンロードが始まる。しばらく待つ
- 終了の確認
エラーメッセージが出ていないこと,および models ディレクトリ以下にモデルファイル(例:pose\body_25\pose_iter_584000.caffemodel など)がダウンロードされていることを確認する(下図は GPU 版の場合)。
getBaseModels.bat のダウンロード元サーバは不安定なことがあり,モデルファイルがダウンロードされないままエラーなく終了する場合がある。その場合,後述のデモ実行時に「Caffe trained model file not found」というエラーになる。models ディレクトリ以下に .caffemodel ファイルが存在することを必ず確認すること。
デモの実行
- GPU 版の場合
Windows で,コマンドプロンプトを実行. 次のコマンドを実行.
次のように実行する
cd C:\openpose-1.7.0-binaries-win64-gpu-python3.7-flir-3d_recommended cd openpose bin\OpenPoseDemo.exe --video examples\media\video.avi
- CPU 版の場合
Windows で,コマンドプロンプトを実行. 次のコマンドを実行.
次のように実行する
cd C:\openpose-1.7.0-binaries-win64-cpu-python3.7-flir-3d cd openpose bin\OpenPoseDemo.exe --video examples\media\video.avi