YOLO Vision 2026:

YOLO26 모델 형식에서 TF.js 모델 형식으로 내보내기#

사용 중단됨 — LiteRT로 대체되었습니다.

Ultralytics 8.4.83 기준으로 tfjs (TensorFlow.js) 내보내기 형식이 제거되었으며 통합된 Google LiteRT 형식으로 대체되었습니다. LiteRT는 LiteRT.js를 통해 (WebGPU 가속 기능과 함께) 브라우저에서 실행되며, 단일 .tflite 모델을 통해 모바일, 임베디드, 엣지는 물론 기존에 TF.js가 처리하던 브라우저 내 및 Node.js 사용 사례를 모두 지원합니다.

format="tfjs"은 여전히 작동하지만 지원 중단(deprecations) 경고를 출력하며 대신 LiteRT 모델을 내보냅니다. 앞으로는 **format="litert"**를 사용하시기 바랍니다. 최신 내보내기 지침과 브라우저 배포 경로는 **LiteRT 내보내기 가이드**를 참조하세요.

머신러닝 모델을 브라우저나 Node.js에 직접 배포하는 것은 까다로울 수 있습니다. 사용자의 기기에서 대화형 애플리케이션을 로컬로 실행할 수 있도록 모델이 더 빠른 성능을 위해 최적화되었는지 확인해야 합니다. TensorFlow.js (TF.js) 모델 형식은 빠른 성능을 제공하면서 최소한의 전력을 사용하도록 설계되었습니다.

'TF.js 모델 형식으로 내보내기' 기능을 사용하면 Ultralytics YOLO26 모델을 고속 로컬 객체 감지 추론에 최적화할 수 있습니다. 이 가이드에서는 모델을 TF.js 형식으로 변환하는 과정을 안내하므로, 다양한 로컬 브라우저와 Node.js 애플리케이션에서 모델이 원활하게 작동하도록 만들 수 있습니다.

TF.js로 내보내야 하는 이유는 무엇인가요?#

더 넓은 TensorFlow 생태계의 일부로 TensorFlow 팀이 개발한 TensorFlow.js로 머신 러닝 모델을 내보내면 머신 러닝 애플리케이션 배포 시 수많은 이점을 얻을 수 있습니다. 민감한 데이터를 기기에 보관하여 사용자 개인정보 보호와 보안을 강화하는 데 도움이 됩니다. 아래 이미지는 TensorFlow.js 아키텍처와 머신 러닝 모델이 웹 브라우저 및 Node.js에서 어떻게 변환되고 배포되는지 보여줍니다.

TensorFlow.js browser ML inference architecture

모델을 로컬에서 실행하면 지연 시간이 줄어들고 더 반응이 빠른 사용자 경험을 제공할 수 있습니다. TensorFlow.js는 오프라인 기능도 제공하므로 인터넷 연결 없이도 애플리케이션을 사용할 수 있습니다. TF.js는 GPU 가속 지원을 통해 확장성이 뛰어나도록 설계되어, 리소스가 제한된 기기에서도 복잡한 모델을 효율적으로 실행할 수 있도록 제작되었습니다.

TF.js의 주요 기능#

개발자를 위한 강력한 도구인 TF.js의 주요 기능은 다음과 같습니다.

  • 플랫폼 간 지원: TensorFlow.js는 브라우저와 Node.js 환경 모두에서 사용할 수 있어 다양한 플랫폼에 유연하게 배포할 수 있습니다. 개발자가 애플리케이션을 더 쉽게 구축하고 배포할 수 있도록 지원합니다.

  • 다중 백엔드 지원: TensorFlow.js는 CPU, GPU 가속을 위한 WebGL, 거의 네이티브에 가까운 실행 속도를 위한 WebAssembly(WASM), 고급 브라우저 기반 머신 러닝 기능을 위한 WebGPU 등 계산을 위한 다양한 백엔드를 지원합니다.

  • 오프라인 기능: TensorFlow.js를 사용하면 인터넷 연결 없이 브라우저에서 모델을 실행할 수 있으므로 오프라인에서도 작동하는 애플리케이션을 개발할 수 있습니다.

TensorFlow.js를 이용한 배포 옵션#

YOLO26 모델을 TF.js 형식으로 내보내는 과정을 시작하기 전에 이 형식이 사용되는 일반적인 배포 시나리오를 살펴보겠습니다.

TF.js는 머신 러닝 모델을 배포하기 위한 다양한 옵션을 제공합니다.

  • 브라우저 내 ML 애플리케이션: 브라우저에서 머신 러닝 모델을 직접 실행하는 웹 애플리케이션을 구축할 수 있습니다. 서버 측 계산이 필요 없어져 서버 부하가 줄어듭니다.

  • Node.js 애플리케이션: TensorFlow.js는 Node.js 환경에서의 배포도 지원하여 서버 측 머신 러닝 애플리케이션 개발을 가능하게 합니다. 서버의 처리 능력이 필요하거나 서버 측 데이터에 액세스해야 하는 애플리케이션에 특히 유용합니다.

  • Chrome 확장 프로그램: 흥미로운 배포 시나리오 중 하나는 TensorFlow.js를 사용하여 Chrome 확장 프로그램을 만드는 것입니다. 예를 들어 웹페이지의 이미지를 마우스 오른쪽 버튼으로 클릭하여 사전 학습된 ML 모델을 사용해 분류할 수 있는 확장 프로그램을 개발할 수 있습니다. TensorFlow.js를 일상적인 웹 브라우징 환경에 통합하여 머신 러닝을 기반으로 즉각적인 통찰력을 제공하거나 기능을 확장할 수 있습니다.

YOLO26 모델을 TensorFlow.js로 내보내기#

YOLO26 모델을 TF.js로 변환하여 모델 호환성과 배포 유연성을 확장할 수 있습니다.

설치#

필수 패키지를 설치하려면 다음을 실행하십시오:

설치
# Install the required package for YOLO26
pip install ultralytics

설치 과정과 관련된 자세한 지침과 모범 사례는 Ultralytics Installation guide를 확인하세요. YOLO26에 필요한 패키지를 설치하는 동안 문제가 발생하면 Common Issues guide에서 해결 방법과 팁을 참고하세요.

사용법#

모든 Ultralytics YOLO26 모델은 기본적으로 내보내기를 지원하도록 설계되어 선호하는 배포 워크플로에 쉽게 통합할 수 있습니다. 지원되는 내보내기 형식 및 구성 옵션 전체 목록 보기를 통해 애플리케이션에 가장 적합한 설정을 선택할 수 있습니다.

tfjs 인수는 이제 로컬에서 Export, Predict, Validate 모드를 지원하고 LiteRT.js를 통해 브라우저에서 실행되는 LiteRT .tflite 모델을 내보냅니다. 현재 브라우저 및 온디바이스 배포 경로는 LiteRT 내보내기 가이드를 참조하세요.

내보내기(Export)
from ultralytics import YOLO

# Load a YOLO26 model
model = YOLO("yolo26n.pt")

# Export the model to TF.js format
model.export(format="litert", imgsz=640)  # use imgsz=224 for classification
예측(Predict) 및 검증(Validate)

내보낸 LiteRT .tflite 모델은 yolo predict 및 yolo val를 사용하여 직접 로드되며 LiteRT.js를 통해 브라우저에서 실행됩니다. LiteRT 내보내기 가이드를 참조하세요.

내보내기 인수#

인수유형기본값설명
formatstr'tfjs'내보낸 모델의 대상 형식이며, 다양한 배포 환경과의 호환성을 정의합니다.
imgszint 또는 tuple640모델 입력에 사용할 원하는 이미지 크기입니다. 정방형 이미지의 경우 정수일 수 있으며, 특정 치수의 경우 튜플 (height, width)일 수 있습니다.
quantizeint 또는 strNone양자화 정밀도: 8(정적 INT8, int8 가중치 + int8 활성화 값; 보정 필요 data/fraction), 'w8a16'(정적, int8 가중치 + int16 활성화 값; 보정 필요 data/fraction), 'w8a32'(동적 INT8, int8 가중치 + FP32 활성화 값; 보정 불필요), 또는 32/미설정(FP32). FP16은 별도로 내보내지지 않으며, FP32 모델은 GPU 델리게이트에서 자동으로 FP16으로 실행됩니다. 더 이상 사용되지 않는 half/int8 플래그를 대체합니다.
batchint1내보낸 모델의 배치 추론 크기 또는 predict 모드에서 내보낸 모델이 동시에 처리할 최대 이미지 수를 지정합니다.
datastrNonedataset YAML의 경로로 양자화에 필수적이며, 분류의 경우 데이터셋 디렉토리 또는 내장 데이터셋 이름을 대신 사용합니다. quantize=8 또는 'w8a16'에서 생략할 경우, Ultralytics는 모델 태스크에 맞는 기본 캘리브레이션 데이터셋을 선택합니다.
fractionfloat, int, 또는 list1.0비율, 이미지 수 또는 [train, val, test] 비율/수로 지정되는 캘리브레이션 서브세트입니다. 두 개의 항목으로 구성된 목록은 test을 전체 상태로 유지하며, 0는 이를 건너뜁니다.
devicestrNone내보내기용 디바이스를 지정합니다: CPU (device=cpu), Apple 실리콘용 MPS (device=mps).

내보내기 프로세스에 대한 자세한 내용은 내보내기에 관한 Ultralytics 문서 페이지를 방문하세요.

내보낸 YOLO26 TensorFlow.js 모델 배포하기#

YOLO26 모델을 내보냈으므로 다음 단계는 배포하는 것입니다. 이 내보내기를 통해 온디바이스 및 LiteRT.js를 통해 브라우저에서 실행되는 LiteRT .tflite 모델이 생성됩니다. 현재 경로는 LiteRT 내보내기 가이드를 참조하세요.

참고용으로, 기존 TensorFlow.js 런타임 리소스는 다음과 같습니다.

요약#

이 가이드에서는 Ultralytics YOLO26 모델을 TensorFlow.js 형식으로 내보내는 방법을 배웠습니다. TF.js로 내보내면 다양한 플랫폼에서 YOLO26 모델을 최적화하고 배포하며 확장할 수 있는 유연성을 확보할 수 있습니다.

사용법에 대한 자세한 내용은 TensorFlow.js 공식 문서를 방문하세요.

Ultralytics YOLO26을 다른 플랫폼 및 프레임워크와 통합하는 방법에 대한 자세한 정보는 통합 가이드 페이지를 확인해 보세요. 프로젝트에서 YOLO26을 최대한 활용하는 데 도움이 되는 풍부한 리소스가 담겨 있습니다.

FAQ#

  • Ultralytics YOLO26 모델을 TensorFlow.js(TF.js) 형식으로 내보내는 것은 간단합니다. 다음 단계를 따르면 됩니다.

    사용법
    from ultralytics import YOLO

# Load a YOLO26 model
model = YOLO("yolo26n.pt")

# Export the model to TF.js format
model.export(format="litert", imgsz=640)  # use imgsz=224 for classification

# The exported '.tflite' model runs in the browser via LiteRT.js or locally with yolo predict/val.

    지원되는 내보내기 옵션에 대한 자세한 내용은 배포 옵션에 관한 Ultralytics 문서 페이지를 방문하세요.

  • YOLO26 모델을 TensorFlow.js로 내보내면 다음과 같은 여러 이점이 있습니다.

    1. 로컬 실행: 모델을 브라우저나 Node.js에서 직접 실행할 수 있어 지연 시간이 줄어들고 사용자 경험이 향상됩니다.
    2. 플랫폼 간 지원: TF.js는 여러 환경을 지원하여 배포 시 유연성을 제공합니다.
    3. 오프라인 기능: 인터넷 연결 없이도 애플리케이션이 작동하도록 하여 신뢰성과 개인정보 보호를 보장합니다.
    4. GPU 가속: WebGL을 활용한 GPU 가속을 통해 리소스가 제한된 기기에서 성능을 최적화합니다.

  • TensorFlow.js는 브라우저 및 Node.js 환경에서 ML 모델을 효율적으로 실행하도록 특별히 설계되었습니다. 브라우저 기반 애플리케이션에 주는 이점은 다음과 같습니다.

    • 지연 시간 감소: 머신 러닝 모델을 로컬에서 실행하여 서버 측 계산에 의존하지 않고 즉각적인 결과를 제공합니다.
    • 개인정보 보호 향상: 민감한 데이터를 사용자의 기기에 유지하여 보안 위험을 최소화합니다.
    • 오프라인 사용 가능: 인터넷 연결 없이도 모델이 작동할 수 있어 일관된 기능을 보장합니다.
    • 다중 백엔드 지원: CPU, WebGL, WebAssembly(WASM), WebGPU와 같은 백엔드를 통해 다양한 계산 요구 사항에 맞는 유연성을 제공합니다.

    TF.js에 대해 더 알아보고 싶으신가요? 공식 TensorFlow.js 가이드를 확인해 보세요.

  • TensorFlow.js의 주요 기능은 다음과 같습니다.

    • 플랫폼 간 지원: TF.js는 웹 브라우저와 Node.js 모두에서 사용할 수 있어 광범위한 배포 유연성을 제공합니다.
    • 다중 백엔드: CPU, GPU 가속을 위한 WebGL, WebAssembly(WASM), 고급 작업을 위한 WebGPU를 지원합니다.
    • 오프라인 기능: 모델을 인터넷 연결 없이 브라우저에서 직접 실행할 수 있어 반응형 웹 애플리케이션 개발에 이상적입니다.

    배포 시나리오 및 자세한 정보는 TensorFlow.js를 이용한 배포 옵션 섹션을 참조하세요.

  • 네, TensorFlow.js는 Node.js 환경에서 YOLO26 모델을 배포할 수 있도록 지원합니다. 이를 통해 서버의 처리 능력과 서버 측 데이터 액세스의 이점을 활용하는 서버 측 머신 러닝 애플리케이션을 구현할 수 있습니다. 일반적인 사용 사례로는 백엔드 서버에서의 실시간 데이터 처리 및 머신 러닝 파이프라인이 있습니다.

    Node.js 배포를 시작하려면 TensorFlow의 Run TensorFlow.js in Node.js 가이드를 참조하세요.

기여자
GLglenn-jocher20LAlakshanthad4RAraimbekovm3FCfcakyon2AMambitious-octopus1ONonuralpszr1PDpderrenger1MAMatthewNoyce1RIRizwanMunawar1ABabirami-vina1

댓글