pixai-tagger をローカルマシンで実行する

ロッゾ=コルン
質問: pixai-tagger
新しく登場した "pixai-tagger" の性能が非常に良いとのうわさを聞いた。ローカルマシンで実行してみたいのだが、 どのようにインストールすればよいのだろうか。情報を頼む。

事前準備

Pythonのインストール

今回はPython 3.12.x をインストールしています。インストールの手順はこちらの記事を参照してください。

Gitのインストール

今回はVisual Studio のGitを利用しています。Git for Windowsを導入する場合はこちらの記事を参照してください。

pixai-tagger のインストール

Hugging Faceからのダウンロード

次のコマンドを実行してHugging Faceからクローンします。

cd (pixai-taggerを配置するディレクトリ)
git clone https://huggingface.co/spaces/deepghs/pixai-tagger-v0.9-demo
cd pixai-tagger-v0.9-demo

仮想環境の作成

次のコマンドを実行してPythonの仮想環境を作成します。

python -m venv .venv
python -m pip install -U pip

.venv\Scripts\Activate.bat
pip install -r requirements.txt


または

python -m venv .venv; .\.venv\Scripts\Activate.ps1
python -m pip install -U pip

.venv\Scripts\Activate.bat
pip install -r requirements.txt

起動用バッチファイルの作成

こちらは必須ではありませんが、簡単に起動できるようにするためのバッチファイルを作成します。
app.py ファイルと同じディレクトリに以下のファイルを作成します。

exec.bat
@echo off

call .venv\Scripts\activate.bat
python app.py

実行

exec.bat を実行するか、仮想環境に切り替えて、python app.py コマンドを実行します。

メモ
初回起動時はモデルのダウンロードが実行されるため、起動されるまでに時間がかかります。

pixai-tagger をローカルマシンで実行する:画像1

Webブラウザで表示されたURLhttp://127.0.0.1:7861/ にアクセスすると下図のページが表氏されます。
pixai-tagger をローカルマシンで実行する:画像2

[画像をここにドロップ - または - クリックしてアップロード]の枠にタグを調べたい画像を設定し、 [Submit]ボタンをクリックします。結果が右側に表示されます。
pixai-tagger をローカルマシンで実行する:画像3

pixai-tagger をローカルマシンで実行できました。

補足:モデルのダウンロードディレクトリ

ダウンロードされたモデルは以下のディレクトリに配置されます。

モデルの配置ディレクトリ
C:\Users\(ログインユーザー名)\.cache\huggingface\hub\models--deepghs--pixai-tagger-v0.9-onnx\snapshots\(GUID的な名称)\model.onnx
AuthorPortraitAlt
著者
iPentecのメインデザイナー
Webページ、Webクリエイティブのデザインを担当。PhotoshopやIllustratorの作業もする。 最近は生成AIの画像生成の沼に沈んでいる。
作成日: 2025-09-13