serengil/deepface

A Lightweight Face Recognition and Facial Attribute Analysis (Age, Gender, Emotion and Race) Library for Python

What it solves

DeepFace は軽量な Python フレームワークで、顔認識と顔属性分析をシンプルにします。検出、アライン、正規化、表現といった複雑なパイプラインを開発者が手動で実装する必要がなく、数行のコードで顔認証、本人検索、人口統計分析を実行できます。

How it works

DeepFace は VGG-Face、FaceNet、ArcFace、GhostFaceNet などの最先端顔認識モデルをハイブリッドにラップします。5 段階のパイプライン（顔検出、アライン、画像正規化、マルチ次元ベクトル（埋め込み）への変換、本人確認）を自動化します。また、RetinaFace、MediaPipe、YOLO といった複数の検出バックエンドや、Cosine、Euclidean といった距離指標をサポートし、顔ベクトル間の類似度を計算します。

Who it’s for

このフレームワークは、深いコンピュータビジョンの専門知識がなくても、アプリケーションに顔認識、リアルタイム映像解析、または顔属性予測を組み込みたい Python 開発者向けに設計されています。

Highlights

  • Multi-Model Support: VGG‑Face、FaceNet、OpenFace、ArcFace など多数のモデルをラップ。
  • Facial Attribute Analysis: 年齢、性別、感情、人種を予測。
  • Flexible Search: ディレクトリベースのデータストアと、PostgreSQL、MongoDB、Pinecone などのデータベースバックエンド検索をサポート。
  • Anti-Spoofing: 画像が実物か偽装かを検出するモジュールを搭載。
  • Real-Time Capabilities: stream 関数でライブウェブカメラ解析が可能。
  • API Ready: 組み込みの REST API と Docker サポートで外部システムとの統合が容易。