동영상에 전사, 프레임 분석, 임베딩을 적용해 색인하고 자연어로 장면을 검색하는 셀프 호스팅·로컬 우선 동영상 지식 베이스입니다.
serengil/deepface
여러 모델과 탐지기를 선택해 사용할 수 있는 얼굴 인식 및 나이·성별·감정·인종 분석용 Python 라이브러리입니다.
- 스타
- 23,650
- 포크
- 3,211
- 열린 이슈
- 4
- 마지막 커밋
- 21시간 전
어떤 프로젝트인가요?
DeepFace는 얼굴 인식과 얼굴 속성 분석을 위한 Python 프레임워크입니다. VGG-Face, FaceNet, ArcFace, OpenFace, SFace를 비롯한 여러 얼굴 인식 모델과 OpenCV, RetinaFace, MTCNN, MediaPipe, YOLO 계열 등 다양한 얼굴 탐지기를 통합해 제공합니다. 개발자는 verify, find, analyze, represent 같은 고수준 함수를 한 줄로 호출할 수 있으며, 탐지, 정렬, 정규화, 벡터 비교는 라이브러리가 백그라운드에서 처리합니다.
일대일 검증과 폴더 기반 검색 외에도 DeepFace는 PostgreSQL, pgvector, MongoDB, Redis, Qdrant 등의 백엔드를 통한 데이터베이스 기반 등록 및 검색을 지원하며, 근사 최근접 이웃 검색을 선택적으로 사용할 수 있습니다. 실시간 웹캠 스트리밍, 스푸핑 방지 검사, 직접 실행하거나 Docker에서 구동할 수 있는 REST 및 gRPC API도 제공합니다. 기본 추론 엔진은 ONNX Runtime이며, TensorFlow와 PyTorch는 선택 항목으로 제공됩니다.
핵심 기능
- 01폴더나 데이터베이스에서 얼굴 검증 및 1:N 얼굴 검색을 수행합니다.
- 02나이, 성별, 감정, 인종 속성을 분석합니다.
- 03인자만 바꿔 여러 인식 모델과 탐지 백엔드를 선택할 수 있습니다.
- 04인식 및 속성 분석을 지원하는 실시간 웹캠 스트리밍을 제공합니다.
- 05가짜 얼굴을 탐지하는 스푸핑 방지 검사를 선택적으로 사용할 수 있습니다.
- 06Docker를 지원하는 REST 및 gRPC API 서버를 제공합니다.
활용 사례
- Python 애플리케이션에 얼굴 로그인이나 신원 확인 기능을 구현할 때.
- 사진 모음에서 특정 인물을 검색할 때.
- 웹이나 모바일 앱에서 호출할 얼굴 분석 마이크로서비스를 운영할 때.
- 얼굴 임베딩이 필요한 컴퓨터 비전 프로젝트를 프로토타이핑할 때.
빠른 시작
- 1
PyPI에서 라이브러리를 설치합니다(기본 백엔드는 ONNX Runtime).
pip install deepface - 2
Python에서 라이브러리를 가져옵니다.
from deepface import DeepFace - 3
두 얼굴 이미지에 같은 사람이 나타나는지 확인합니다.
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 같은 고수준 함수를 한 줄로 호출할 수 있으며, 탐지, 정렬, 정규화, 벡터 비교는 라이브러리가 백그라운드에서 처리합니다.
- deepface은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- deepface은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- deepface은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. deepface의 마지막 커밋은 2026년 11월 5일입니다.
- deepface은(는) 어디에 사용할 수 있나요?
- Python 애플리케이션에 얼굴 로그인이나 신원 확인 기능을 구현할 때. 사진 모음에서 특정 인물을 검색할 때. 웹이나 모바일 앱에서 호출할 얼굴 분석 마이크로서비스를 운영할 때. 얼굴 임베딩이 필요한 컴퓨터 비전 프로젝트를 프로토타이핑할 때.
- deepface는 어떻게 설치하나요?
- PyPI에서 라이브러리를 설치합니다(기본 백엔드는 ONNX Runtime).: pip install deepface Python에서 라이브러리를 가져옵니다.: from deepface import DeepFace 두 얼굴 이미지에 같은 사람이 나타나는지 확인합니다.: result: dict = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")
- deepface은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/serengil/deepface
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
얼굴 감지, 인식, 추적, 랜드마크, 파싱, 시선, 속성 분석, 안티스푸핑을 하나의 API로 제공하는 통합 Python 라이브러리입니다.
레이블 없이 비전 모델을 학습할 수 있도록 PyTorch 구성 요소를 제공하는 이미지 자기지도 학습용 Python 라이브러리입니다.
ONNXRuntime, MNN, TensorRT 등을 지원하며 객체 탐지, 얼굴 인식, 세그멘테이션, 매팅용 AI 모델 100개 이상을 제공하는 경량 C++ 툴킷입니다.
직접 보유한 카메라에서 객체·움직임·얼굴을 감지하는 셀프 호스팅 로컬 전용 NVR 및 AI 컴퓨터 비전 소프트웨어입니다.
Windows와 macOS에서 완전히 오프라인으로 작동하며, 얼굴·날짜·위치별로 사진을 정리하는 개인정보 보호 우선 데스크톱 앱입니다.