Immich Power Tools：Immichライブラリを一括整理するためのツール

このプロジェクトが存在する理由

READMEの冒頭には背景があります。作者はGoogle PhotosライブラリをImmichに移行しましたが、アセットとアルバムは移行できたものの、整理ツールは制約が強すぎると感じました。このプロジェクトは、Immich自体にはない一括操作（複数の人物レコードを一度に更新する、似た顔をマージするなど）を処理するために存在します。非公式のImmichクライアントとして説明されており、Immichプロジェクトの一部ではありません。

ツールが提供する機能

機能リストには、高度なフィルターによる人物データの一括更新、顔の類似性に基づく人物マージ提案、類似アセットから座標をコピーして欠落位置を補完する機能、人物とアセットのパターンから作成可能なアルバム提案、経時アセット数やEXIFデータなどのライブラリ分析、自然言語によるスマート検索、そしてタイムスタンプのずれを修正する一括日付オフセットが含まれます。READMEのチェックリストでは、スマートマージ、アルバムの一括削除と共有、潜在アルバム、アルバム内の人物、欠落位置、EXIFと経時グラフを含む統計、ダークモード、Dockerサポート、認証、GitHub Packagesへの公開が実装済みとされています。一括編集やフィルターなどは未チェックです。

Immichと一緒に実行する

このツールはImmichと並行して実行するように設計されています。Docker Composeでは、READMEにサンプルサービス定義があり、データボリューム、8001から3000へのポートマッピング、env_fileを備えたpower-toolsコンテナを追加します。環境ファイルにはIMMICH_API_KEY、IMMICH_URL、EXTERNAL_IMMICH_URL、DB_PORT、DB_HOSTを含める必要があり、DB_HOSTはImmichデータベースコンテナを指します。Portainerの方法では、同じネットワークに接続したdocker runコマンドを使用します。READMEによると、Power Tools v0.22.0以上ではImmich 3.0以降が必要です。ローカル開発ではbunが必要で、.env.exampleを.envにコピーしてbun run devを実行し、Postgresポートを公開します。

スマート検索と外部サービス

Findと呼ばれるスマート検索機能は、OpenAI互換APIを使用して自然言語クエリを解析します。READMEにはOpenAI、Groq、OllamaやLM Studioなどのローカルプロバイダーの例があり、AI_BASE_URLとAI_MODELの環境変数を設定します。検索テキストのみがAIプロバイダーに送信され、個人のライブラリデータは共有されないと明記されています。実際のアセット検索はImmichのSmart Search APIを使用します。ヒートマップにはGoogle Maps JavaScript APIキーを使用し、位置データのみがGoogle Mapsに送信されるとあります。どちらのサービスもオプションで、READMEにはヒートマップ描画とAI解析のコード位置へのリンクがあります。

技術スタック、ライセンス、リポジトリの状態

リポジトリはTypeScriptで書かれ、インフラにNext.js、スタイリングにTailwind CSS、UIコンポーネントにShadcn、API呼び出しにAxiosを使用しています。ライセンスはAGPL-3.0で、その前文はソフトウェアをコピー、配布、変更する自由を保証し、ネットワークサーバーソフトウェアでは変更後のソースコードをサーバーの利用者に提供する必要があると述べています。リポジトリメタデータによると、プロジェクトは2,640スター、53フォーク、119のオープンイシューで、アーカイブされていません。READMEはまだ反復開発中だと述べています。

READMEに記載されていないこと

READMEにはパフォーマンスベンチマーク、セキュリティ監査、本番稼働時間の保証は含まれていません。また、Immich 3.0互換性の注意以外のバージョン履歴や、変更ログも記載されていません。ライセンス文には無保証の記述がありますが、提供された抜粋には完全な免責事項は含まれていません。これらの詳細が必要な場合、ソース資料からは確認できません。導入前に Immich の接続先 URL と認証情報の扱いを分けて確認し、検索や整理の操作が意図したアカウントだけに作用するテスト用アセットで実行します。特に重複整理、メタデータ変更、外部サービス連携は元に戻せるかを操作単位で記録し、README が示す Immich 3.0 の互換性注意が自分のサーバー版にも当てはまるかを照合してください。画面上で成功と表示されても、Immich 側のアセット数、アルバム所属、メタデータ値を API または管理画面で確認し、Power Tools の操作前後で差分を残します。README にない自動削除や同期の挙動は、機能一覧から推測せず、テスト用ライブラリで結果を確認してから扱うべきです。検索条件を変えた際の対象件数と、整理後に Immich のタイムラインで表示される結果も照合し、意図しない一括変更が起きていないことを確かめます。検索結果の並び替えやアルバム整理を複数回実行した場合にも、同じ対象が再処理されないかを確認し、操作前のバックアップと作業後の差分を保持します。

編集部の結論

Immich Power ToolsはAGPL-3.0ライセンスの活発なプロジェクトで、ライブラリの一括整理のための明確な機能セットを備えています。パフォーマンスベンチマークやセキュリティ監査はREADMEには記載されていません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes