Immich

Immich は、オープンソースのセルフホスト型写真・動画管理プラットフォームであり、自動バックアップ、スマート検索、クロスデバイスアクセスをサポートします。

手動でプログラムをダウンロードして AI Pyramid にアップロードするか、以下のコマンドでモデルリポジトリを取得します。

提示

git lfs がインストールされていない場合は、先に git lfs インストール手順を参照してインストールしてください。

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

ファイル説明：

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

docker イメージをインポート

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

作業ディレクトリの準備

提示

unzip がインストールされていない場合は、先に apt install zip -y コマンドでインストールしてください。

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

コンテナを起動

提示

4GB バージョンの AI Pyramid を使用している場合は、プログラムが正常に動作するように、事前に仮想メモリの追加を参照してください。

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

依存パッケージをインストール

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 # プリコンパイルパッケージは更新される可能性があるため、実際のファイル名を基準にしてください。

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. 

ブラウザで AI Pyramid の IP アドレスと 2283 ポートを入力します。例：192.168.20.105:2283

注意：初回アクセス時には管理者アカウントの登録が必要で、アカウントとパスワードはローカルに保存されます。