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 지원으로 외부 시스템과의 통합이 용이합니다.