serengil/deepface

これは何？

主な機能

• 01フォルダまたはデータベースを対象とした顔認証と1:N顔検索。
• 02年齢、性別、感情、人種の属性分析。
• 03引数で切り替え可能な複数の顔認識モデルと検出バックエンド。
• 04顔認識と属性分析に対応したWebカメラのリアルタイムストリーミング。
• 05偽の顔を検知するオプションのなりすましチェック。
• 06Dockerにも対応したRESTおよびgRPC APIサーバー。

ユースケース

• Pythonアプリケーションに顔認証ログインや本人確認機能を組み込む。
• 写真コレクションから特定の人物を検索する。
• Webアプリやモバイルアプリから呼び出すマイクロサービスとして顔分析を実行する。
• 顔の埋め込み表現が必要なコンピュータービジョンプロジェクトのプロトタイプを作成する。

クイックスタート

1. 1

   PyPIからライブラリをインストールする（デフォルトのバックエンドはONNX Runtime）

   pip install deepface
2. 2

   Pythonでライブラリをインポートする

   from deepface import DeepFace
3. 3

   2枚の顔画像に写っている人物が同一かどうかを確認する

   result: dict = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")

使う前に知っておきたいこと

• !顔認識や属性分析にはプライバシーと倫理上の懸念が伴うため、導入先の法規制を確認してください。
• !TensorFlowまたはPyTorchのフルバックエンドを使うと、依存関係が数GB追加される場合があります。

収録されている特集

トピック

よくある質問

deepface とは？

年齢・性別・感情・人種の分析にも対応した、複数のモデルや検出器を切り替えて使える顔認識・顔属性分析用Pythonライブラリ。 DeepFaceは、顔認識と顔属性分析のためのPythonフレームワークです。VGG-Face、FaceNet、ArcFace、OpenFace、SFaceなど複数の顔認識モデルに加え、OpenCV、RetinaFace、MTCNN、MediaPipe、YOLOの各種モデルなど、さまざまな顔検出器を利用できます。verify、find、analyze、representといった高レベル関数を1行で呼び出せば、検出、アラインメント、正規化、ベクトル比較はライブラリがバックグラウンドで処理します。

deepface は無料で使えますか？ライセンスは？

deepface は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

deepface は今もメンテナンスされていますか？

活発にメンテナンス中。deepface の最終コミットは 2026年11月7日 です。

deepface は何に使えますか？

Pythonアプリケーションに顔認証ログインや本人確認機能を組み込む。 写真コレクションから特定の人物を検索する。 Webアプリやモバイルアプリから呼び出すマイクロサービスとして顔分析を実行する。 顔の埋め込み表現が必要なコンピュータービジョンプロジェクトのプロトタイプを作成する。

deepface のインストール方法は？

PyPIからライブラリをインストールする（デフォルトのバックエンドはONNX Runtime）: pip install deepface Pythonでライブラリをインポートする: from deepface import DeepFace 2枚の顔画像に写っている人物が同一かどうかを確認する: result: dict = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")

deepface はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/serengil/deepface