PyAutoGUI インストール方法

📖 はじめに

この記事では、PyAutoGUIをPython環境へインストールする方法を説明します。

PyAutoGUIはPyPI（Python Package Index）で公開されているため、pipを使用して簡単に導入できます。

また、画像認識機能を利用する場合には追加ライブラリのインストールも必要になるため、その方法についても紹介します。

🛠️ インストール前の準備

PyAutoGUIを利用するには、あらかじめPythonがインストールされている必要があります。

Pythonがインストール済みであれば、次のコマンドでバージョンを確認できます。

python --version

環境によっては次のコマンドを使用します。

python3 --version

WindowsではPython Launcher（pyコマンド）がインストールされている場合、py --versionでも確認できます。

📦 PyAutoGUIのインストール

最も基本的なインストール方法は次のコマンドです。

pip install pyautogui

Windowsでは次のように実行することもできます。

py -m pip install pyautogui

Pythonを複数インストールしている環境では、対象のPythonに対応したpipを利用してください。

インストールが完了すると、PyAutoGUI本体と必要な依存ライブラリが自動的にインストールされます。

🔍 インストールの確認

インストール後はPythonからインポートできることを確認します。

import pyautogui

print("PyAutoGUIが利用できます。")

エラーが表示されなければ、インストールは正常に完了しています。

まずはインポートだけを確認し、その後にマウス操作やキーボード操作を試すと、問題の切り分けが容易になります。

🖼️ 画像認識を利用する場合

PyAutoGUIには画像認識機能がありますが、この機能を使用するにはOpenCVを追加でインストールすることを推奨します。

pip install opencv-python

画像認識機能では、指定した画像と画面上の表示を比較し、一致する位置を検索できます。

OpenCVを利用すると検索速度や認識性能が向上し、confidence（一致率）の指定も利用できるようになります。

OpenCVがインストールされていない場合でも画像検索は利用できますが、一部機能が制限されます。

🧰 よく一緒に利用されるライブラリ

GUI自動化では、次のライブラリと組み合わせて利用されることが多くあります。

ライブラリ	用途
OpenCV	画像認識・テンプレートマッチング
Pillow	画像処理・スクリーンショット
pytesseract	OCR（文字認識）
NumPy	画像データ処理

これらを組み合わせることで、

ボタンを画像認識で探す
画面内の文字を読み取る
条件によって処理を分岐する

といった高度な自動化が実現できます。

🖥️ 仮想環境での利用

Pythonでは、プロジェクトごとに仮想環境（Virtual Environment）を作成することが推奨されています。

仮想環境を作成する例を示します。

python -m venv .venv

Windowsでは仮想環境を有効化します。

.venv\Scripts\activate

macOS・Linuxでは次のコマンドを使用します。

source .venv/bin/activate

有効化後にPyAutoGUIをインストールします。

pip install pyautogui

仮想環境を利用すると、プロジェクトごとにライブラリのバージョンを管理できるため、他のPythonプロジェクトへの影響を防げます。

⚠️ よくあるトラブル

📌 ModuleNotFoundError が表示される

インストールしたPythonと、実行しているPythonが異なる可能性があります。

現在使用しているPythonを確認してください。

python -m pip --version

または

py -m pip --version

📌 pip が見つからない

次のようなメッセージが表示されることがあります。

'pip' は内部コマンドまたは外部コマンドとして認識されていません。

この場合は、python -m pipまたはpy -m pipを使用してください。

📌 画像認識で confidence が使えない

confidence引数を使用するにはOpenCVが必要です。

次のコマンドで追加インストールしてください。

pip install opencv-python

画像認識を利用する予定がある場合は、最初にOpenCVもインストールしておくことをおすすめします。

🔐 実行時の注意

PyAutoGUIは実際にマウスやキーボードを操作します。

そのため、テスト中は不用意にPCを操作すると、クリック位置や入力内容が変わってしまうことがあります。

また、自動入力によりファイルの削除や送信など意図しない操作が実行される可能性もあります。

初めて動作確認を行う場合は、重要なアプリケーションや業務システムを閉じた状態でテストしてください。 誤操作によるデータの変更や削除を防ぐことができます。

📝 まとめ

PyAutoGUIはpipを使用して簡単にインストールできます。

基本的なGUI操作だけであればPyAutoGUI本体のみで利用できますが、画像認識を活用する場合はOpenCVも合わせて導入することをおすすめします。

また、仮想環境を利用することで、ライブラリの管理が容易になり、安全に開発を進めることができます。