Repolode
제출하기
huggingface

huggingface/transformers.js

ONNX Runtime을 사용해 서버 없이 브라우저나 JavaScript 런타임에서 Hugging Face Transformers 모델을 실행합니다.

GitHub에서 보기웹사이트
스타
16,359
포크
1,206
열린 이슈
279
마지막 커밋
어제

어떤 프로젝트인가요?

Transformers.js는 브라우저에서 사전 학습된 Hugging Face Transformers 모델을 실행하는 JavaScript 라이브러리입니다. Pipeline API는 Python transformers 라이브러리와 유사하게 설계되어, Python으로 작성한 코드도 비슷한 구조로 포팅할 수 있습니다. 분류, 객체 탐지, 음성 인식, 텍스트 음성 변환, 제로샷 분류 등 텍스트, 비전, 오디오, 멀티모달 입력을 다루는 여러 작업을 지원합니다.

이 라이브러리는 ONNX Runtime으로 모델을 실행하며, 기본적으로 WASM을 통해 CPU에서 실행하고 WebGPU를 사용해 GPU에서 실행하는 옵션도 제공합니다. 개발자는 q8이나 q4 같은 양자화 수준을 선택해 모델 크기와 대역폭 사용량을 줄일 수 있습니다. Hugging Face Hub의 모델은 ID로 불러올 수 있으며, PyTorch, TensorFlow, JAX 모델은 Optimum을 사용해 ONNX로 변환할 수 있습니다.

npm으로 설치하거나 ES module import를 사용해 CDN에서 불러올 수 있어 번들러 없이도 사용할 수 있습니다. 로컬 모델 경로와 WASM 파일 위치도 설정할 수 있습니다.

핵심 기능

  • 01Python transformers 라이브러리와 유사한 Pipeline API를 제공합니다.
  • 02NLP, 컴퓨터 비전, 오디오 및 멀티모달 작업을 지원합니다.
  • 03기본적으로 WASM을 통해 CPU에서 실행하며, WebGPU 가속도 선택할 수 있습니다.
  • 04dtype 옵션으로 q8, q4 같은 양자화 모델을 지원합니다.
  • 05npm으로 설치하거나 번들러 없이 CDN에서 바로 사용할 수 있습니다.

활용 사례

  • 백엔드 없이 웹 앱에 클라이언트 측 감성 분석이나 분류 기능을 추가합니다.
  • 개인정보 보호가 중요한 입력을 브라우저에서 음성 인식이나 텍스트 음성 변환에 사용합니다.
  • 정적 사이트에서 의미 검색을 위한 텍스트 임베딩을 계산합니다.
  • 서버에 배포하기 전에 JavaScript에서 Hugging Face 모델을 프로토타이핑합니다.

빠른 시작

  1. 1

    NPM에서 패키지를 설치합니다

    npm i @huggingface/transformers
  2. 2

    JavaScript 코드에서 pipeline을 가져와 감성 분석 모델을 실행합니다

사용 전 알아둘 점

  • 많은 브라우저에서 WebGPU 지원은 아직 실험 단계입니다.
  • 모델은 ONNX 형식이어야 하므로 PyTorch, TensorFlow 또는 JAX 모델은 먼저 변환해야 합니다.

토픽

#machine-learning#javascript#browser#onnx#webgpu#transformers#nlp#inference#webml

자주 묻는 질문

transformers.js은(는) 무엇인가요?
ONNX Runtime을 사용해 서버 없이 브라우저나 JavaScript 런타임에서 Hugging Face Transformers 모델을 실행합니다. Transformers.js는 브라우저에서 사전 학습된 Hugging Face Transformers 모델을 실행하는 JavaScript 라이브러리입니다. Pipeline API는 Python transformers 라이브러리와 유사하게 설계되어, Python으로 작성한 코드도 비슷한 구조로 포팅할 수 있습니다. 분류, 객체 탐지, 음성 인식, 텍스트 음성 변환, 제로샷 분류 등 텍스트, 비전, 오디오, 멀티모달 입력을 다루는 여러 작업을 지원합니다.
transformers.js은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
transformers.js은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
transformers.js은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. transformers.js의 마지막 커밋은 2026년 10월 20일입니다.
transformers.js은(는) 어디에 사용할 수 있나요?
백엔드 없이 웹 앱에 클라이언트 측 감성 분석이나 분류 기능을 추가합니다. 개인정보 보호가 중요한 입력을 브라우저에서 음성 인식이나 텍스트 음성 변환에 사용합니다. 정적 사이트에서 의미 검색을 위한 텍스트 임베딩을 계산합니다. 서버에 배포하기 전에 JavaScript에서 Hugging Face 모델을 프로토타이핑합니다.
transformers.js는 어떻게 설치하나요?
NPM에서 패키지를 설치합니다: npm i @huggingface/transformers JavaScript 코드에서 pipeline을 가져와 감성 분석 모델을 실행합니다
transformers.js은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/huggingface/transformers.js

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트