AI Pyramid - Immich 写真管理システム

Immich は、オープンソースのセルフホスト型写真・ビデオ管理プラットフォームであり、自動バックアップ、AI スマート検索、クロスデバイスアクセスをサポートしています。AI Pyramid の計算能力による加速を利用することで、効率的な画像認識とセマンティック検索機能を実現できます。

1. デプロイリソースの取得

以下のいずれかの方法で Immich のデプロイリソースを取得してください：

方法 1：手動ダウンロード

Immich リソースリポジトリにアクセスしてダウンロードし、AI Pyramid デバイスにアップロードします。

方法 2：コマンドラインでのクローン

依存関係の確認

システムに git lfs がインストールされていない場合は、git lfs インストールガイドを参照してインストールしてください。

git clone https://huggingface.co/AXERA-TECH/immich

1.1 リソースファイルの説明

クローン完了後のディレクトリ構造は以下の通りです：

root@m5stack-AI-Pyramid:~/rsp/immich# ls -lh
total 421M
drwxrwxr-x 2 axera axera 4.0K Dec 23 17:23 asset
-rw-rw-r-- 1 axera axera 421M Dec 23 17:23 ax-immich-server-aarch64.tar.gz
-rw-rw-r-- 1 axera axera    0 Dec 23 17:22 config.json
-rw-rw-r-- 1 axera axera 7.6K Dec 23 17:23 docker-deploy.zip
-rw-rw-r-- 1 axera axera 104K Dec 23 17:23 immich_ml-1.129.0-py3-none-any.whl
-rw-rw-r-- 1 axera axera 9.4K Dec 23 17:22 README.md
-rw-rw-r-- 1 axera axera  177 Dec 23 17:22 requirements.txt

2. Docker コンテナのデプロイ

ステップ 1：イメージのインポート

cd immich
docker load -i ax-immich-server-aarch64.tar.gz

ステップ 2：作業ディレクトリの準備

依存関係の確認

システムに unzip がインストールされていない場合は、apt install zip -y コマンドを実行してインストールしてください。

unzip docker-deploy.zip
cp example.env .env

ステップ 3：コンテナの起動

メモリ設定

AI Pyramid の 4GB メモリ版を使用している場合は、プログラムを正常に動作させるために、起動前に仮想メモリ追加チュートリアルを参照してください。

docker compose -f docker-compose.yml -f docker-compose.override.yml up -d

起動成功後の出力例：

root@m5stack-AI-Pyramid:~/rsp/immich# docker compose -f docker-compose.yml -f docker-compose.override.yml up -d
WARN[0000] /root/rsp/immich/docker-compose.override.yml: `version` is obsolete
[+] Running 3/3
✔ Container immich_redis     Running                                                                                                    0.0s
✔ Container immich_postgres  Running                                                                                                    0.0s
✔ Container immich_server    Running                                                                                                    0.0s

3. ML 推論サービスのデプロイ

ステップ 1：依存パッケージのインストール

pip install https://github.com/AXERA-TECH/pyaxengine/releases/download/0.1.3.rc2/axengine-0.1.3-py3-none-any.whl
pip install -r requirements.txt
pip install immich_ml-1.129.0-py3-none-any.whl

バージョンに関するヒント

プリコンパイル済みのパッケージはバージョンアップに伴い変更される可能性があるため、実際のディレクトリ内のファイル名に従ってインストールしてください。

ステップ 2：ML サービスの起動

Python のシンボリックリンクを作成し、immich_ml サービスを起動します：

ln -s /usr/bin/python3 /usr/bin/python
IMMICH_HOST=0.0.0.0 IMMICH_PORT=3003 python3 -m immich_ml

サービス起動成功時の出力例：

root@m5stack-AI-Pyramid:~/rsp/immich# IMMICH_HOST=0.0.0.0 IMMICH_PORT=3003 python3 -m immich_ml
[12/30/25 10:59:50] INFO     Starting gunicorn 23.0.0
[12/30/25 10:59:50] INFO     Listening at: http://0.0.0.0:3003 (14537)
[12/30/25 10:59:50] INFO     Using worker: immich_ml.config.CustomUvicornWorker
[12/30/25 10:59:50] INFO     Booting worker with pid: 14546
2025-12-30 10:59:52.776738850 [W:onnxruntime:Default, device_discovery.cc:164 DiscoverDevicesForPlatform] GPU device discovery failed: device_discovery.cc:89 ReadFileContents Failed to open file: "/sys/class/drm/card1/device/vendor"
[INFO] Available providers:  ['AxEngineExecutionProvider']
/usr/local/lib/python3.10/dist-packages/immich_ml/models/clip/cn_vocab.txt
[12/30/25 11:00:06] INFO     Started server process [14546]
[12/30/25 11:00:06] INFO     Waiting for application startup.
[12/30/25 11:00:06] INFO     Created in-memory cache with unloading after 300s of inactivity.
[12/30/25 11:00:06] INFO     Initialized request thread pool with 8 threads.
[12/30/25 11:00:06] INFO     Application startup complete. 

4. 初期設定

4.1 Web インターフェースへのアクセス

ブラウザを使用して Immich 管理画面にアクセスします。アドレスバーに AI Pyramid の IP アドレスとポート 2283 を入力します：

http://192.168.x.x:2283

初回アクセス

初回アクセス時には管理者アカウントの登録が必要です。アカウント情報はローカルに保存されます。

4.2 機械学習サービスの設定

設定完了後、設定画面で機械学習サーバーを設定します。左側のメニューから設定画面に入ります：

URL フィールドに AI Pyramid の IP アドレスとポート 3003 を入力します：

http://192.168.x.x:3003

必要に応じて CLIP モデルを選択します：

中国語検索：ViT-L-14-336-CN__axera と入力
英語検索：ViT-L-14-336__axera と入力

設定完了後、[Save] をクリックします：

接続の問題

サーバーがオフラインと表示される場合は、クライアントでプロキシが有効になっていないか確認してください。プロキシをオフにしてからページをリフレッシュして再試行してください。

4.3 スマート検索の有効化

初めて使用する場合は、インデックス作成ジョブを手動でトリガーする必要があります。[Jobs] オプションに入り、[SMART SEARCH] を手動で有効にします：

immich_ml サービスが自動的に CLIP モデルをダウンロードし、初期化します：

5. スマート検索の使用

検索バーに写真のキーワードや説明を入力すると、システムは AI セマンティック検索技術を使用して、関連する写真やビデオを自動的に検索します：

Next 概要

デバイスとクイックスタート

AI Pyramid

Module LLM

LLM630 Compute Kit

モデルの紹介

Qwen2.5

Qwen3

DeepSeek-R1

SmolVLM

MeloTTS

Whisper

Llama

AI Pyramid Applications

アプリケーション

Audio

CVビジョンアプリケーション

VLMマルチモーダル

大規模言語モデル (LLM)

音声アシスタント

OpenAI API