ncoevoet/facet

Facet は、セルフホスト型の写真分析・選別ツールです。完全に自分のマシン上で動作し、写真フォルダを読み取り、各画像を9つの品質指標（美学、構図、シャープネス、露出など）でスコアリングし、結果を任意のブラウザで開けるウェブギャラリーに表示します。クラウドも、アカウントも、APIキーも不要です。すべての写真はお使いのハードウェア上に残ります。

主要なワークフロー:

1. スキャン — 写真フォルダをFacetに指定します。各画像の品質、構図、顔を分析します。JPG、HEIC、10種類のカメラRAW形式、PNG、GIFなどに対応。
2. ブラウズ — ウェブギャラリーを開き、フィルタ、検索、複数のレイアウトで探索します。
3. 選別 — Facetは連写ショット（バースト）をグループ化し、閉じた目をフラグし、視覚的に類似した写真を見つけ、最良の候補を表面化するので、弱いものをすばやく削除できます。

主要機能（グループ別）:

• スコアリング: 写真ごとに9つのメトリクスを提供し、コンテンツタイプ（ポートレート、風景、マクロなど）に応じて重みを調整。任意の写真にホバーすると、スコアの内訳とEXIFデータがツールチップで表示されます。
• 選別: 自動ベスト選択付きバースト検出、シーケンス認識（パノラマ/ブラケットはまとめて保持）、類似性グループ化、時系列の「シーン」グループ化、ドライラン・プレビュー付きワンクリック自動選別、ジャンルプリセット（スポーツ/ウェディング/コンサート）、瞬き検出、知覚ハッシュによる重複検出、スクリーンショット/ドキュメント/ミームを捕捉する「ジャンク・スイープ」。
• ブラウジング: モザイクビューとグリッドビュー、日付/カメラ/レンズ/人物/評価フィルタ、自然言語セマンティック検索（「ビーチの夕日」）、タイムラインビュー、位置情報対応マップ、テーマ付きスライドショー「カプセル」、「この日の思い出」、フォルダナビゲーション。
• 整理: 人物グループ化とマージ提案付き自動顔認識、手動およびスマートアルバム、スター評価、AIタグ、アンドゥ付きバッチ操作、キーボードショートカット。
• 理解: 機材/カテゴリ/タイムラインのダッシュボード、各スコアのAI批評、A/B写真比較付き重み調整、あなたの決定から学習するパーソナル「テイスト」ランカー、ヒストグラム表示、AIキャプション。
• 共有: 共有可能なアルバムリンク（受信者のログイン不要）、コメント付きクライアント校正モード、WebDAV経由の携帯電話自動アップロード、フォトフレーム/キオスクフィード、静的ポートフォリオエクスポート、CSV/JSONエクスポート。
• その他: ダーク/ライトモード（10アクセントカラー）、モバイル対応レスポンシブインターフェース、PWAとしてインストール可能、仮想化ギャラリー（10万枚以上の写真でも高速）、再開可能なスキャン、7つのUI言語、マルチユーザーサポート、プラグイン/ウェブフック。

ハードウェアの現実:

• ほとんどの機能はCPUのみのマシンで動作します—スコアリング、顔検出、検索、アルバム、メタデータエクスポート。
• Apple SiliconはPyTorchのMetalバックエンドを介してGPUを自動的に使用します。
• NVIDIA GPU（16GBまたは24GB VRAM）で最強のAIモデルが利用可能：TOPIQ美学スコアリング、SigLIP埋め込み、VLMタグ付け、AIキャプション/批評、被写体顕著性。
• ローカルGPUがない場合、AIテキスト機能をリモートのOllamaまたはOpenAI互換サーバーにポイントできます。

対象ユーザー:

• ローカルの大規模な写真ライブラリを持ち、ベストショットを見つけて、バーストや類似画像をトリミングしたい人。
• プライバシーを重視し、Lightroom、darktable、digiKam、Immichなどを既に使用している人—Facetは評価とタグをXMPサイドカーファイル（デフォルトでは元ファイルは変更なし）に書き込み、外部編集を読み戻し、双方向同期のためのLightroomプラグインを提供します。
• モバイルクラウドアプリではありません。RAWファイルを編集せず、セットアップ（Pythonインストール、最良のモデルにはGPUが必要）が必要です。

クイックスタート: Dockerを推奨 — クローン、.env.exampleをコピー、写真ディレクトリを設定、docker compose upを実行、http://localhost:5000を開きます。Linux/macOS用にinstall.shを介したDocker不要のルートもあります。初回実行のウォークスルー、完全なドキュメント、設定リファレンスはdocs/フォルダにあります。

ライセンス: Facetの独自コードはMIT。一部のデフォルトAIモデル（TOPIQ、InsightFaceウェイト）は非商用です。commercialライセンスモードは、自動的に許容ライセンスの代替にルーティングします。