Repolode
yakhyo

yakhyo/uniface

顔検出、認識、追跡、ランドマーク、パース、視線推定、属性分析、なりすまし防止を1つのAPIで提供する、統合型Pythonライブラリです。

スター
2,203
フォーク
310
未解決の Issue
5
最終コミット
7 時間前

これは何?

UniFaceは、顔検出、認識、追跡、顔ランドマーク、フェイスメッシュ、パース、マッティング、頭部姿勢、視線、属性分析、感情、顔の状態、品質スコアリング、なりすまし防止、匿名化を1つのインターフェースにまとめた顔分析用Pythonライブラリです。FaceAnalyzerクラスを使えば、検出、アラインメント、認識を1回の呼び出しで実行できます。また、FairFaceやAgeGenderなどの属性予測器を追加して、検出した各顔のフィールドを補完できます。

モデルはONNX Runtimeを通じてCPU、Apple Silicon、NVIDIA CUDAで動作します。インストールはpipで行い、cpuまたはgpuのextraを指定できます。重みは初回使用時にダウンロードされ、SHA-256で検証されます。利用可能なモデルにはRetinaFace、SCRFD、ArcFace、AdaFace、BiSeNet、MODNet、MiniFASNetなどがあります。

一部の学習済み重みには、ライブラリのMITライセンスとは異なるライセンスが適用されます。そのため、商用利用の前に各モデルのライセンスを確認するよう、プロジェクトは利用者に求めています。

主な機能

  • 01検出、認識、追跡を1つのFaceAnalyzerパイプラインで実行
  • 023Dフェイスメッシュを含む、68〜478点のランドマーク
  • 03年齢、性別、人種、感情、顔の状態に対応する属性予測器
  • 04頭部姿勢と視線の推定
  • 05なりすまし防止、顔の品質スコアリング、5種類の匿名化用ぼかし方式
  • 06ONNX Runtimeを介してCPU、Apple Silicon、CUDAで動作

ユースケース

  • Pythonのコンピュータビジョンプロジェクトに顔検出・認識を追加する
  • フレーム間で顔を追跡する動画パイプラインを構築する
  • 写真や動画の顔を匿名化する
  • 顔照合とあわせて生体検知を実行する

クイックスタート

  1. 1

    CPU版をインストールします(Apple Siliconでも動作します)

    pip install "uniface[cpu]"
  2. 2

    または、NVIDIA CUDA版をインストールします

    pip install "uniface[gpu]"
  3. 3

    最初のスクリプトを実行します:写真から顔を検出し、その属性を表示します

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

  • 一部の事前学習済みモデルの重みはMITライセンスではないため、商用利用の前に確認が必要です。

収録されている特集

トピック

#computer-vision#face-recognition#face-detection#onnxruntime#deep-learning#facial-landmarks#face-alignment#face-analysis#face-anonymization#face-anti-spoofing

よくある質問

uniface とは?
顔検出、認識、追跡、ランドマーク、パース、視線推定、属性分析、なりすまし防止を1つのAPIで提供する、統合型Pythonライブラリです。 UniFaceは、顔検出、認識、追跡、顔ランドマーク、フェイスメッシュ、パース、マッティング、頭部姿勢、視線、属性分析、感情、顔の状態、品質スコアリング、なりすまし防止、匿名化を1つのインターフェースにまとめた顔分析用Pythonライブラリです。FaceAnalyzerクラスを使えば、検出、アラインメント、認識を1回の呼び出しで実行できます。また、FairFaceやAgeGenderなどの属性予測器を追加して、検出した各顔のフィールドを補完できます。
uniface は無料で使えますか?ライセンスは?
uniface は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
uniface は今もメンテナンスされていますか?
活発にメンテナンス中。uniface の最終コミットは 2026年11月7日 です。
uniface は何に使えますか?
Pythonのコンピュータビジョンプロジェクトに顔検出・認識を追加する フレーム間で顔を追跡する動画パイプラインを構築する 写真や動画の顔を匿名化する 顔照合とあわせて生体検知を実行する
uniface のインストール方法は?
CPU版をインストールします(Apple Siliconでも動作します): pip install "uniface[cpu]" または、NVIDIA CUDA版をインストールします: pip install "uniface[gpu]" 最初のスクリプトを実行します:写真から顔を検出し、その属性を表示します
uniface はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/yakhyo/uniface

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト