Repolode
yakhyo

yakhyo/uniface

얼굴 감지, 인식, 추적, 랜드마크, 파싱, 시선, 속성 분석, 안티스푸핑을 하나의 API로 제공하는 통합 Python 라이브러리입니다.

스타
2,203
포크
310
열린 이슈
5
마지막 커밋
7시간 전

어떤 프로젝트인가요?

UniFace는 얼굴 감지, 인식, 추적, 얼굴 랜드마크, 페이스 메시, 파싱, 매팅, 머리 자세, 시선, 인구통계학적 특성, 감정, 얼굴 상태, 품질 점수 산출, 안티스푸핑, 익명화를 하나의 인터페이스로 제공하는 얼굴 분석 Python 라이브러리입니다. FaceAnalyzer 클래스를 사용하면 한 번의 호출로 감지, 정렬, 인식을 수행할 수 있으며, FairFace나 AgeGender 같은 속성 예측기를 추가해 감지된 각 얼굴의 추가 필드를 채울 수 있습니다.

모델은 CPU, Apple Silicon, NVIDIA CUDA에서 ONNX Runtime으로 실행되며, cpu 또는 gpu extra를 지정해 pip로 설치합니다. 가중치는 처음 사용할 때 다운로드되며 SHA-256으로 검증됩니다. 모델 목록에는 RetinaFace, SCRFD, ArcFace, AdaFace, BiSeNet, MODNet, MiniFASNet 등이 포함됩니다.

일부 사전 학습 가중치에는 라이브러리의 MIT 라이선스와 다른 라이선스가 적용되므로, 상업적으로 사용하기 전에 모델 라이선스를 확인할 것을 권장합니다.

핵심 기능

  • 01감지, 인식, 추적을 하나의 FaceAnalyzer 파이프라인에서 수행
  • 023D 페이스 메시를 포함해 68~478개 지점의 랜드마크 제공
  • 03나이, 성별, 인종, 감정, 얼굴 상태를 예측하는 속성 예측기
  • 04머리 자세 및 시선 추정
  • 05안티스푸핑, 얼굴 품질 점수 산출, 다섯 가지 익명화 블러 방식
  • 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은(는) 무엇인가요?
얼굴 감지, 인식, 추적, 랜드마크, 파싱, 시선, 속성 분석, 안티스푸핑을 하나의 API로 제공하는 통합 Python 라이브러리입니다. UniFace는 얼굴 감지, 인식, 추적, 얼굴 랜드마크, 페이스 메시, 파싱, 매팅, 머리 자세, 시선, 인구통계학적 특성, 감정, 얼굴 상태, 품질 점수 산출, 안티스푸핑, 익명화를 하나의 인터페이스로 제공하는 얼굴 분석 Python 라이브러리입니다. FaceAnalyzer 클래스를 사용하면 한 번의 호출로 감지, 정렬, 인식을 수행할 수 있으며, 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 통계는 매일 갱신됩니다.

관련 프로젝트