Facetとは
Facetは、Webギャラリーを備えたローカルの写真分析・選別エンジンで、画像を採点したうえで、結果を閲覧・選別・整理できます。READMEによれば、すべてが自分のマシン上で動き、クラウド、アカウント、APIキーは不要で、コードはMITライセンスです。
LICENSEファイルには著作権者としてNicolas Coevoetの名があります。作業は2つのツールに分かれ、コマンドラインから起動するスキャナーと、ブラウザにギャラリーを提供するビューアです。
入手方法
Facetは、ソースのリポジトリからDockerまたはインストールスクリプトでインストールします。プロジェクトは、インストーラー、アプリストアの掲載、リリースのバイナリを公開していません。
項目 | 入手方法 |
|---|---|
| Docker(推奨) | インストールガイド:クローンし、写真フォルダを指定して docker compose up |
| Dockerなし | クローンして bash install.sh を実行し、python facet.py と python viewer.py を起動(Linux、macOS) |
| ドキュメント | リポジトリのdocsフォルダ |
| ウェブサイト | ncoevoet.github.io/facet |
| ソースコード | github.com/ncoevoet/facet(MIT) |
| リリース | GitHubリリース(リリースノートのみ) |
確認したバージョンはv1.25.0で、GitHubのリリースによると2026年10月27日に公開されました。リポジトリへの最後のプッシュは2026年10月28日です。インストールにはターミナル、Git、DockerまたはPythonが必要で、ダブルクリックで入るものではなく開発者向けの導入です。プロジェクトのサイトにも読んだドキュメントにも、独立したプライバシーポリシーのページは見つかりませんでした。プライバシーに関する記述はREADMEにあります。
動作要件
ドキュメントによれば、FacetはCPUのあるマシンならどれでも動き、NVIDIA GPUまたはメモリの多いApple SiliconのMacで最も強力なモデルが使えます。
プロファイル
- 情報源の記載:
- legacy:CPUのみ、8gb:NVIDIA 6〜14 GB、16gb:NVIDIA 14〜20 GB、24gb:NVIDIA 20 GB以上
初回ダウンロード
- 情報源の記載:
- ドキュメントによれば一度だけで、legacyは約4.7 GB、8gbは約6.9 GB、16gbは約14.6 GB、24gbは約19.1 GB
Apple Silicon
- 情報源の記載:
- TorchモデルにMetalバックエンドを使用。autoプロファイルは統合メモリの合計で決まり、32 GBで16gbに達します
メモリ
- 情報源の記載:
- ドキュメントにRAMの最小値はありません。メモリ上限付きのコンテナは、大きなプロファイルでスキャン中に停止することがあると警告しています
ソフトウェア
- 情報源の記載:
- Docker。手動インストールならPython 3.12(3.10以上でも可)と、ギャラリーのビルド用にNode.js 20以上
対応OS
- 情報源の記載:
- Windows、macOS、Linux。WindowsではドキュメントがDockerを案内し、NVIDIA GPUにはWSL2を案内しています
写真の形式
- 情報源の記載:
- JPEG、HEIC、10種類のRAW、PNG、WebP、TIFF、AVIF、JPEG XLなど
これらの数値はプロジェクトのドキュメントによるものです。PromptQuorumは、どのハードウェアでもスキャン時間やメモリ使用量を測定していません。
始め方
以下の手順はプロジェクトのドキュメントに沿ったもので、PromptQuorumは実行していません。
- 1コードを取得してフォルダを指定
Why it matters: リポジトリをクローンし、.env.exampleを.envにコピーして、PHOTOS_DIRに写真フォルダを設定します。 - 2Facetを起動
Why it matters: docker compose up -d を実行します。NVIDIAのカードがある場合は、そのサイズ用のcomposeファイルを追加するか、Dockerなしでインストールスクリプトを使います。 - 3スキャンしてダウンロードを待つ
Why it matters: 最初のスキャンでプロファイル用のモデルをダウンロードし、データベースを作成して写真を採点します。処理中もギャラリーは閲覧できます。 - 4ギャラリーを開いてパスワードを設定
Why it matters: ブラウザでビューアを開き、Dockerイメージが一度だけ表示するeditionパスワードでログインします。ポートを共有する前に、ビューアのパスワードを設定してください。
主な機能
以下の項目はすべてプロジェクトのREADMEまたはドキュメントによるもので、PromptQuorumはどれも試していません。
- 採点。写真ごとに9つの観点(美的品質、構図、顔の品質、目のシャープさ、露出など)で採点し、コンテンツのカテゴリ(30以上)ごとに重み付けします。
- 選別。連写・類似写真・シーンのグループ、まばたきの検出、ほぼ重複する写真の検出、ドライランのプレビュー付き自動選別に対応し、露出ブラケットやパノラマはまとめて残します。
- 閲覧。モザイクとグリッド表示、フィルター、タイムライン、地図、スマートアルバムを含むアルバム、テーマ別スライドショー、「この日の思い出」。
- 整理。名前を付けた人物と統合の提案、星の評価、タグ、短時間で取り消せる一括操作。
- 共有と連携。クライアント確認モード付きのアルバムリンク、Lightroom・darktable・digiKam向けのXMPサイドカー、スマートフォンからのアップロード用WebDAV受信箱、Immichとの評価の同期。
AI機能と実行場所
中核のAIは画像向けで、品質を採点するモデル、検索用の埋め込み、顔モデル、被写体の検出です。文章のタグ、キャプション、講評は任意の視覚言語モデルが生成します。
- 品質スコア。16gbと24gbのプロファイルは美的スコアにTOPIQを使い、legacyと8gbは美的ヘッドを持つCLIP埋め込みを使います。LIQEなどの補助的な採点モデルは、どのプロファイルでも使えるとドキュメントに記載されています。
- 検索。「海辺の夕日」のような入力を埋め込みと照合します。16gbと24gbではSigLIP 2、legacyと8gbではOpenCLIP ViT-L-14です。
- 顔。InsightFaceが顔を検出・認識し、クラスタリングで人物にまとめます。任意のMediaPipe blendshapesで、まばたきと笑顔の判定が精密になります。
- 被写体。BiRefNetが被写体と背景を分け、ピントと構図を判断します。
- My Taste。A/B比較、評価、選別の判断が、重みの最適化と個人用ランキングに反映されます。
- 視覚言語モデル。タグ、キャプション、講評は、16gbと24gbでは同一プロセス内で動き、vlm_backendで指定したリモートのOllamaまたはOpenAI互換サーバーでも動かせます。その場合、画像はそのサーバーに送られます。
データの流れとプライバシー
READMEによれば、すべてが自分のマシン上で動き、クラウド、アカウント、APIキーは不要です。ドキュメントによれば、スキャンは写真を読み取るだけで、結果はFacet自身のデータベースに書き込まれます。モデルは初回の利用時にHugging Face、PyIQA、InsightFaceの配布元からローカルのキャッシュにダウンロードされます。そのダウンロード後にオフラインで動作するかどうかは、PromptQuorumは試していません。
ドキュメントとソースコードで確認できた外部への通信は次のとおりです。updates.enabledがfalseでない限り7日ごとにGitHubへ最新リリースを問い合わせる更新確認、ブラウザがOpenStreetMapのタイルサーバーから読み込む地図タイル、ジオコーダーPhotonに言及するGPS編集ダイアログ、そしてvlm_backendをOllamaやOpenAI互換サーバーに設定した場合にのみ、そこへ送る画像です。ビューアのスクリプトは既定ですべてのインターフェースで待ち受けており、viewer.passwordが空のあいだは、ポートに届く人なら誰でもライブラリを閲覧し、オリジナルをダウンロードできます。MCPアシスタント向けのエンドポイントは既定で有効で、オープンな環境では読み取り専用の匿名キーを提供し、viewer.mcp.enabledをfalseにすると無効になります。
📌補足: これらはプロジェクトの説明と、ドキュメントおよびソースコードについてのPromptQuorumの読み取りです。ネットワーク通信は調べておらず、そのほかのソースコードも監査していません。
モデルのライセンス
Facet自身のコードはMITライセンスですが、既定でダウンロードされるモデルの一部は商用利用が許諾されていません。プロジェクトのライセンスページは、pyiqa(TOPIQ、LIQEなどの採点モデル)をPolyForm NoncommercialのコードとCC BY-NC-SAの重み、InsightFaceのbuffalo_lの重みを非商用の研究用途のみとしています。GitHubのAPIはこのリポジトリのライセンスを認識していないため、LICENSEファイルを直接確認してください。
licensing.modeをcommercialにすると、Facetは寛容なライセンスのモデルだけを使います。制限付きのコンポーネントはインポートもダウンロードもされず、顔にはYuNetとSFaceなどの代替が割り当てられます。標準のインストールスクリプトとDockerイメージには制限付きのパッケージが含まれ、商用インストールだけではモードは切り替わりません。このページは情報であり、法的助言ではないとも記されています。
📌補足: 業務でFacetを使う予定がある場合は、既定の設定に頼る前に、各モデルのライセンスをご自身で確認してください。
向いている人
- 大きなライブラリを持つ写真家で、編集の前に連写、まばたき、ほぼ重複する写真を整理したい方。
- セルフホスト利用者で、自然言語検索と顔のグループ化を備えた非公開のギャラリーがほしく、Dockerに慣れている方。
- Lightroom、darktable、digiKamのユーザーで、スコアとセレクトを標準的なサイドカーファイルとして書き戻したい方。
確認できなかった点
- AIの品質。採点の精度、顔のグループ化、検索の適合度、スキャン速度は試していません。README自身も美的スコアを概算としています。
- オフライン利用。最初のモデルのダウンロード後に、Facetが完全にオフラインで動くかどうかは確認していません。
- リリースの安定性。v1.23.1のノートによると、v1.23.0はCUDA版のDockerイメージなしで公開されました。2026年10月24日から27日のあいだに3つのバージョンが出ているため、変更が速い点に注意してください。
- サポート。READMEは、商用の選別ツールのようなサポートのない個人開発プロジェクトと説明しています。
- インストール手順。セットアップのコマンドはドキュメントによるもので、PromptQuorumは実行していません。
競合と代替ツール
ディレクトリには、同じ分野でレビュー済みの写真・画像ライブラリツールがほかに3つあります。
Immich
- 対応プラットフォーム:
- サーバー(Docker)、iOS、Android、ブラウザ
- 価格/ライセンス:
- 無料/AGPL-3.0
- 主な違い:
- スマートフォンのバックアップと検索。FacetのREADMEによれば、Facetは品質の採点と選別を加え、評価をImmichと同期できます
Immichに関する記事(1件)
- Immich Review: Self-Hosted Photo Library with Smart Search更新日 2026年10月26日
PhotoPrism
- 対応プラットフォーム:
- サーバー(Docker)、ブラウザ
- 価格/ライセンス:
- 無料のCommunity/AGPL-3.0
- 主な違い:
- AI搭載のセルフホスト型フォトライブラリ。FacetのREADMEは、Immichと並べて整理・検索・バックアップ向けのツールに分類しています
PhotoPrismに関する記事(1件)
PixlStash
- 対応プラットフォーム:
- Windows・macOS・Linuxのデスクトップアプリ、Web
- 価格/ライセンス:
- 無料/GPL-3.0
- 主な違い:
- ローカルのタグ付け、キャプション、ComfyUI連携を備えた画像ライブラリで、デスクトップアプリとして導入します
PixlStashに関する記事(1件)
各アプリの最新の価格、ライセンス、対応プラットフォームは、それぞれのページでご確認ください。
よくある質問
FacetにGPUは必要ですか。
いいえ。legacyプロファイルなら、採点、顔、タグ、選別、ギャラリーをCPUで実行できます。ただし遅くなります。TOPIQ、SigLIP 2、内蔵のキャプションにはNVIDIAの16gbまたは24gbプロファイルが必要で、vlm_backendをリモートサーバーに向ける場合は別です。
Facetは写真を変更したり削除したりしますか。
ドキュメントによれば、スキャンは写真を読み取るだけです。評価やキーワードをファイルに書き込むのは別の任意の操作で、却下した写真をゴミ箱へ移せるのはviewer.cull.allow_trashが有効な場合に限られます。
スマートフォンからFacetを使えますか。
ネイティブアプリはありません。ギャラリーはレスポンシブでインストール可能なWebアプリで、ドキュメントにはPhotoSyncや任意のWebDAVアプリから監視対象の受信箱へアップロードする方法が載っています。
Facetを商用で使うには。
商用ビルドをインストールし、licensing.modeをcommercialに設定して、現在のライセンス状況を表示するdoctorコマンドを実行します。そのうえでモデルのライセンスのページを読んでください。
ギャラリーを非公開に保つには。
viewer.passwordを設定し、ビューアをHTTPS対応のリバースプロキシの背後に置きます。デプロイのドキュメントにnginxとCaddyの例があります。
総評
Facetは、大量のローカル写真を採点・選別・閲覧するための、無料で活発に更新されている手段で、顔のグループ化と自然言語検索が自分のマシン上で動きます。一方で、導入にはターミナルと初回の大きなモデルダウンロードが必要で、プロジェクトのライセンスページによれば既定のモデルの重みの一部は商用利用が許諾されておらず、ドキュメントによればビューアはパスワードを設定するまで開いたままで、任意の機能1つが画像をリモートサーバーに送る可能性があり、AIの品質に関する記述はここでは確認できませんでした。Dockerに慣れた写真家やセルフホスト利用者に向いています。ダブルクリックで使えるアプリやLLMアシスタントを求める方は、ほかを探してください。
情報源
- Facetのウェブサイト:機能の概要とクイックスタート。2026年10月28日に確認。
- FacetのREADME:機能、要件、ライセンス、他ツールとの比較。2026年10月28日に確認。
- Facetのドキュメント:インストール、設定、デプロイ、AIエージェントのページ。2026年10月28日に確認。
- サードパーティのモデルとライセンス:各モデルのライセンス。2026年10月28日に確認。
- GitHubのFacet:リリースとコミットの状況。2026年10月28日に確認。
