YOLO-World 모델
YOLO-World 모델은 Ultralytics YOLOv8을 기반으로 하는 실시간 오픈 어휘 검출 방식입니다. 설명 텍스트를 바탕으로 이미지에서 객체를 검출합니다. 경쟁력 있는 정확도를 유지하면서 연산 부담을 낮춰 다양한 비전 애플리케이션에 적합합니다.
시청: 사용자 지정 데이터셋에서 YOLO World 학습 워크플로

개요#
YOLO-World는 많은 컴퓨팅 리소스가 필요한 대규모 Transformer 모델에 의존하는 기존 Open-Vocabulary 탐지 모델의 한계를 해결합니다. 반면 폐쇄형 탐지기는 사전에 정의된 객체 카테고리에 의존하므로 동적 시나리오에서의 활용이 제한됩니다. YOLO-World는 개방형 어휘 탐지를 위해 YOLOv8 프레임워크를 확장하고, 비전-언어 모델링과 대규모 데이터셋 사전 학습을 활용하여 제로샷 시나리오에서 다양한 객체를 효율적으로 식별합니다.
인스턴스 마스크, 시각적 프롬프트 또는 프롬프트가 필요 없는 모드도 필요한 오픈 보캐뷸러리 작업에는 동일한 set_classes() API를 사용하는 YOLOE를 참조하세요.
주요 기능#
-
실시간 솔루션: 빠른 CNN을 기반으로 구축된 YOLO-World는 즉각적인 결과가 필요한 애플리케이션에서 사용할 수 있을 만큼 빠른 개방형 어휘 탐지를 제공합니다.
-
효율성과 성능: YOLO-World는 정확도를 유지하면서 컴퓨팅 및 리소스 요구 사항을 줄여, 더 무거운 Transformer 기반 개방형 어휘 탐지기의 효율적인 대안을 제공하고 실시간 애플리케이션을 지원합니다.
-
오프라인 어휘를 이용한 추론: YOLO-World는 효율성을 더욱 높이기 위해 오프라인 어휘를 사용하는 "프롬프트 후 탐지" 전략을 도입합니다. 이 방식에서는 캡션이나 카테고리와 같이 미리 계산한 사용자 지정 프롬프트를 인코딩하여 오프라인 어휘 임베딩으로 저장할 수 있어 탐지 프로세스를 간소화합니다.
-
YOLOv8 기반: Ultralytics YOLOv8을 기반으로 구축된 YOLO-World는 실시간 탐지 아키텍처를 개방형 어휘 탐지에 맞게 조정하여 빠르고 정확한 탐지를 제공합니다.
-
벤치마크 우수성: 단일 NVIDIA V100 GPU에서 측정한 표준 벤치마크의 속도와 효율성 면에서 YOLO-World는 MDETR 및 GLIP 시리즈를 비롯한 기존 개방형 어휘 탐지기보다 뛰어난 성능을 보입니다.
-
다양한 활용: YOLO-World의 효율성은 다양한 비전 작업에서 개방형 어휘 탐지를 실용적으로 구현할 수 있게 하며, 이전 개방형 어휘 방식보다 훨씬 빠르게 실행됩니다.
사용 가능한 모델, 지원 작업 및 작동 모드#
이 섹션에서는 사용 가능한 모델과 각 모델의 사전 학습 가중치, 지원 작업, 그리고 학습, 검증, 추론, 내보내기와 같은 다양한 실행 모드와의 호환성을 자세히 설명합니다. ✅는 지원되는 모드를, ❌는 지원되지 않는 모드를 나타냅니다.
모든 YOLOv8-World 가중치는 공식 YOLO-World 저장소에서 직접 이전되었으며, 해당 가중치의 저작자는 원저자입니다.
| 모델 유형 | 사전 학습 가중치 | 지원 작업 | 학습 | 검증 | 추론 | 내보내기 |
|---|---|---|---|---|---|---|
| YOLOv8s-world | yolov8s-world.pt | 객체 탐지 | ✅ | ✅ | ✅ | ❌ |
| YOLOv8s-worldv2 | yolov8s-worldv2.pt | 객체 탐지 | ✅ | ✅ | ✅ | ✅ |
| YOLOv8m-world | yolov8m-world.pt | 객체 탐지 | ✅ | ✅ | ✅ | ❌ |
| YOLOv8m-worldv2 | yolov8m-worldv2.pt | 객체 탐지 | ✅ | ✅ | ✅ | ✅ |
| YOLOv8l-world | yolov8l-world.pt | 객체 탐지 | ✅ | ✅ | ✅ | ❌ |
| YOLOv8l-worldv2 | yolov8l-worldv2.pt | 객체 탐지 | ✅ | ✅ | ✅ | ✅ |
| YOLOv8x-world | yolov8x-world.pt | 객체 탐지 | ✅ | ✅ | ✅ | ❌ |
| YOLOv8x-worldv2 | yolov8x-worldv2.pt | 객체 탐지 | ✅ | ✅ | ✅ | ✅ |
COCO 데이터셋에서의 제로샷 전이#
| 모델 유형 | mAP50-95 | mAP50 | mAP75 |
|---|---|---|---|
| yolov8s-world | 37.4 | 52.0 | 40.6 |
| yolov8s-worldv2 | 37.7 | 52.2 | 41.0 |
| yolov8m-world | 42.0 | 57.0 | 45.6 |
| yolov8m-worldv2 | 43.0 | 58.4 | 46.8 |
| yolov8l-world | 45.7 | 61.3 | 49.8 |
| yolov8l-worldv2 | 45.8 | 61.3 | 49.8 |
| yolov8x-world | 47.0 | 63.0 | 51.2 |
| yolov8x-worldv2 | 47.1 | 62.8 | 51.4 |
사용 예시#
Ultralytics는 YOLO-World 모델을 위한 Python API와 CLI 명령어를 제공합니다.
시청: Ultralytics를 활용한 YOLO-World 모델 사용 예시 | 개방형 어휘, 프롬프트 불필요 등
학습 사용법#
결정론적 학습을 지원하고 ONNX 및 TensorRT와 같은 형식으로 더 쉽게 내보낼 수 있으므로, 사용자 지정 학습에는 yolov8-worldv2 사용을 적극 권장합니다.
아래의 COCO8 예시 데이터셋을 사용하여 train 방식으로 YOLO-World 객체 탐지 모델을 학습합니다:
PyTorch 사전 학습된 *.pt 모델과 구성 *.yaml 파일을 YOLOWorld() 클래스에 전달하여 Python에서 모델 인스턴스를 생성할 수 있습니다:
from ultralytics import YOLOWorld
# 사전 학습된 YOLOv8s-worldv2 모델 로드
model = YOLOWorld("yolov8s-worldv2.pt")
# COCO8 예제 데이터셋으로 100 에포크 동안 모델 학습
results = model.train(data="coco8.yaml", epochs=100, imgsz=640)
# 'bus.jpg' 이미지에서 YOLO-World 모델로 추론 실행
results = model("path/to/bus.jpg")예측 사용법#
아래와 같이 predict 방식으로 객체 탐지를 실행합니다:
from ultralytics import YOLOWorld
# YOLO-World 모델 초기화
model = YOLOWorld("yolov8s-world.pt") # 또는 다양한 크기를 사용하려면 yolov8m/l-world.pt를 선택합니다.
# 지정된 이미지에서 YOLOv8s-world 모델로 추론 실행
results = model.predict("path/to/image.jpg")
# 결과 표시
results[0].show()이 코드 조각은 사전 학습된 모델을 불러와 이미지에서 예측을 실행합니다.
검증 사용법#
다음과 같이 데이터셋에서 모델을 검증합니다:
from ultralytics import YOLO
# YOLO-World 모델 생성
model = YOLO("yolov8s-world.pt") # 또는 다양한 크기를 사용하려면 yolov8m/l-world.pt를 선택합니다.
# COCO8 예제 데이터셋에서 모델 검증 수행
metrics = model.val(data="coco8.yaml")추적 사용법#
다음과 같이 YOLO-World 모델로 동영상 또는 이미지에서 객체 추적을 실행합니다:
from ultralytics import YOLO
# YOLO-World 모델 생성
model = YOLO("yolov8s-world.pt") # 또는 다양한 크기를 사용하려면 yolov8m/l-world.pt를 선택합니다.
# 비디오에서 YOLO-World 모델로 추적
results = model.track(source="path/to/video.mp4")Ultralytics에서 제공하는 YOLO-World 모델에는 오프라인 어휘의 일부로 COCO 데이터셋 카테고리가 사전 설정되어 있어 즉시 사용할 수 있습니다. 따라서 YOLOv8-World 모델은 추가 설정이나 사용자 지정 없이 COCO 데이터셋에 정의된 80개의 표준 카테고리를 바로 인식하고 예측할 수 있습니다.
프롬프트 설정#

YOLO-World 프레임워크에서는 사용자 지정 프롬프트를 통해 클래스를 동적으로 지정할 수 있으므로, 재학습 없이 모델을 특정 요구 사항에 맞게 조정할 수 있습니다. 이 기능은 원래 학습 데이터에 포함되지 않았던 새로운 도메인이나 특정 작업에 모델을 적용할 때 특히 유용합니다. 사용자 지정 프롬프트를 설정하면 관심 객체를 대상으로 모델을 안내하여 탐지 결과의 관련성과 정확도를 높일 수 있습니다.
예를 들어, 애플리케이션에서 'person' 및 'bus' 객체만 탐지하면 되는 경우 이러한 클래스를 직접 지정할 수 있습니다.
from ultralytics import YOLO
# YOLO-World 모델 초기화
model = YOLO("yolov8s-world.pt") # 또는 yolov8m/l-world.pt를 선택합니다.
# 사용자 지정 클래스 정의
model.set_classes(["person", "bus"])
# 이미지에서 지정된 카테고리에 대한 예측 실행
results = model.predict("path/to/image.jpg")
# 결과 표시
results[0].show()일부 사용자는 빈 문자열 ""을 배경 클래스로 추가하면 특정 상황에서 탐지 성능이 향상될 수 있다고 확인했습니다. 이러한 동작은 상황에 따라 달라지는 것으로 보이며, 정확한 메커니즘은 완전히 밝혀지지 않았습니다.
model.set_classes(["person", "bus", ""])빈 문자열은 저장하는 모든 모델에서 독립적인 클래스로 model.names에 유지되므로, 해당 탐지 결과에는 빈 레이블이 반환됩니다. 예측 시 classes=[0, 1]을 전달하면 실제 클래스만 유지할 수 있습니다.
사용자 지정 클래스를 설정한 후 모델을 저장할 수도 있습니다. 이렇게 하면 특정 사용 사례에 맞게 특화된 YOLO-World 모델 버전을 만들 수 있습니다. 이 과정에서는 사용자 지정 클래스 정의를 모델 파일에 직접 포함하므로 추가 조정 없이 지정한 클래스를 사용할 수 있는 모델이 준비됩니다. 사용자 지정 YOLO-World 모델을 저장하고 로드하려면 다음 단계를 따르세요.
먼저 YOLO-World 모델을 로드하고 사용자 지정 클래스를 설정한 다음 저장합니다.
from ultralytics import YOLO
# YOLO-World 모델 초기화
model = YOLO("yolov8s-world.pt") # 또는 yolov8m/l-world.pt를 선택합니다.
# 사용자 지정 클래스 정의
model.set_classes(["person", "bus"])
# 정의된 오프라인 어휘와 함께 모델 저장
model.save("custom_yolov8s.pt")저장 후 custom_yolov8s.pt 모델은 다른 사전 학습된 YOLOv8 모델과 동일하게 동작하지만 한 가지 중요한 차이가 있습니다. 정의한 클래스만 탐지하도록 최적화되어 있다는 점입니다. 이러한 사용자 지정은 특정 애플리케이션 시나리오에서 탐지 성능과 효율성을 크게 향상시킬 수 있습니다.
from ultralytics import YOLO
# 사용자 지정 모델 로드
model = YOLO("custom_yolov8s.pt")
# 사용자 지정 클래스를 탐지하도록 추론 실행
results = model.predict("path/to/image.jpg")
# 결과 표시
results[0].show()사용자 지정 어휘로 저장할 때의 이점#
- 효율성: 관련 객체에 초점을 맞춰 탐지 과정을 간소화하고, 계산 오버헤드를 줄이며 추론 속도를 높입니다.
- 유연성: 대규모 재학습이나 데이터 수집 없이도 새로운 탐지 작업이나 틈새 작업에 모델을 쉽게 적용할 수 있습니다.
- 간편성: 런타임마다 사용자 지정 클래스를 반복해서 지정할 필요가 없어 배포가 간소화되고, 내장된 어휘를 사용해 모델을 바로 사용할 수 있습니다.
- 성능: 정의된 객체를 인식하는 데 모델의 주의와 리소스를 집중시켜 지정된 클래스의 탐지 정확도를 높입니다.
이 방식은 재학습 없이 특정 작업에 맞게 객체 탐지 모델을 사용자 지정하므로, 더 다양한 애플리케이션에서 개방형 어휘 탐지를 실용적으로 활용할 수 있습니다.
처음부터 공식 결과 재현(실험적)#
데이터셋 준비#
- 학습 데이터
| 데이터셋 | 유형 | 샘플 | 박스 | 주석 파일 |
|---|---|---|---|---|
| Objects365v1 | 탐지 | 609k | 9621k | objects365_train.json |
| GQA | 그라운딩 | 621k | 3681k | final_mixed_train_no_coco.json |
| Flickr30k | 그라운딩 | 149k | 641k | final_flickr_separateGT_train.json |
- 검증 데이터
| 데이터셋 | 유형 | 주석 파일 |
|---|---|---|
| LVIS minival | 탐지 | minival.txt |
처음부터 학습 시작#
WorldTrainerFromScratch은 탐지 데이터셋과 그라운딩 데이터셋에서 YOLO-World 모델을 동시에 학습할 수 있도록 고도로 사용자 지정되었습니다.
from ultralytics import YOLOWorld
from ultralytics.models.yolo.world.train_world import WorldTrainerFromScratch
# 옵션 1: Python 딕셔너리 사용
data = {
"train": {
"yolo_data": ["Objects365.yaml"],
"grounding_data": [
{
"img_path": "flickr30k/images",
"json_file": "flickr30k/final_flickr_separateGT_train.json",
},
{
"img_path": "GQA/images",
"json_file": "GQA/final_mixed_train_no_coco.json",
},
],
},
"val": {"yolo_data": ["lvis.yaml"]},
}
# 옵션 2: YAML 파일 사용(yolo_world_data.yaml)
# train:
# yolo_data:
# - Objects365.yaml
# grounding_data:
# - img_path: flickr/full_images/
# json_file: flickr/annotations/final_flickr_separateGT_train_segm.json
# - img_path: mixed_grounding/gqa/images
# json_file: mixed_grounding/annotations/final_mixed_train_no_coco_segm.json
# val:
# yolo_data:
# - lvis.yaml
model = YOLOWorld("yolov8s-worldv2.yaml")
model.train(
data=data, # YAML 파일을 사용하는 경우 data="yolo_world_data.yaml"을 사용합니다.
batch=128,
epochs=100,
trainer=WorldTrainerFromScratch,
)인용 및 감사의 글#
YOLO-World를 활용한 실시간 오픈 보캐뷸러리 객체 탐지 분야의 선구적인 연구를 수행한 Tencent AILab Computer Vision Center에 깊이 감사드립니다.
@article{cheng2024yolow,
title={YOLO-World: Real-Time Open-Vocabulary Object Detection},
author={Cheng, Tianheng and Song, Lin and Ge, Yixiao and Liu, Wenyu and Wang, Xinggang and Shan, Ying},
journal={arXiv preprint arXiv:2401.17270},
year={2024}
}자세한 내용은 arXiv에서 YOLO-World 원본 논문을 확인할 수 있습니다. 프로젝트의 소스 코드와 추가 리소스는 GitHub 저장소에서 확인할 수 있습니다. 이 분야의 발전에 기여하고 귀중한 통찰을 커뮤니티와 공유해 주신 데 감사드립니다.
자주 묻는 질문#
YOLO-World 모델은 Ultralytics YOLOv8 프레임워크를 기반으로 한 실시간 객체 탐지 방식입니다. 설명 텍스트를 바탕으로 이미지 내 객체를 식별하여 개방형 어휘 탐지를 수행합니다. 비전-언어 모델링과 대규모 데이터셋 사전 학습을 활용하는 YOLO-World는 컴퓨팅 요구 사항을 줄이면서 높은 효율성을 달성하므로 실시간 애플리케이션에 적합합니다.
YOLO-World는 효율성을 높이기 위해 오프라인 어휘를 사용하는 "프롬프트 후 탐지" 전략을 지원합니다. 캡션이나 특정 객체 카테고리와 같은 사용자 지정 프롬프트는 미리 인코딩되어 오프라인 어휘 임베딩으로 저장됩니다. 이 방식은 재학습 없이 탐지 프로세스를 간소화합니다. 아래와 같이 모델 내에서 프롬프트를 동적으로 설정하여 특정 탐지 작업에 맞게 조정할 수 있습니다:
from ultralytics import YOLOWorld # YOLO-World 모델 초기화 model = YOLOWorld("yolov8s-world.pt") # 사용자 지정 클래스 정의 model.set_classes(["person", "bus"]) # 이미지에서 예측 실행 results = model.predict("path/to/image.jpg") # 결과 표시 results[0].show()YOLO-World는 기존 오픈 보캐뷸러리 탐지 모델에 비해 다음과 같은 여러 장점을 제공합니다.
- 실시간 성능: 빠른 CNN을 사용하여 신속하고 효율적으로 탐지합니다.
- 효율성과 낮은 리소스 요구량: YOLO-World는 컴퓨팅 및 리소스 요구량을 크게 낮추면서도 높은 성능을 유지합니다.
- 사용자 지정 프롬프트: 모델은 프롬프트를 동적으로 설정할 수 있어 사용자가 재학습 없이 사용자 지정 탐지 클래스를 지정할 수 있습니다.
- 벤치마크 우수성: 표준 벤치마크에서 속도와 효율성 모두 MDETR 및 GLIP과 같은 다른 오픈 보캐뷸러리 탐지 모델보다 뛰어납니다.
Python API 또는 CLI를 사용하여 데이터셋에서 YOLO-World 모델을 학습합니다. Python으로 학습을 시작하는 방법은 다음과 같습니다:
from ultralytics import YOLOWorld # 사전 학습된 YOLOv8s-worldv2 모델 로드 model = YOLOWorld("yolov8s-worldv2.pt") # COCO8 데이터셋에서 100 에포크 동안 모델 학습 results = model.train(data="coco8.yaml", epochs=100, imgsz=640)또는 CLI 사용:
yolo train model=yolov8s-worldv2.pt data=coco8.yaml epochs=100 imgsz=640Ultralytics는 다양한 작업과 작동 모드를 지원하는 여러 사전 학습 YOLO-World 모델을 제공합니다:
모델 유형 사전 학습 가중치 지원 작업 학습 검증 추론 내보내기 YOLOv8s-world yolov8s-world.pt 객체 탐지 ✅ ✅ ✅ ❌ YOLOv8s-worldv2 yolov8s-worldv2.pt 객체 탐지 ✅ ✅ ✅ ✅ YOLOv8m-world yolov8m-world.pt 객체 탐지 ✅ ✅ ✅ ❌ YOLOv8m-worldv2 yolov8m-worldv2.pt 객체 탐지 ✅ ✅ ✅ ✅ YOLOv8l-world yolov8l-world.pt 객체 탐지 ✅ ✅ ✅ ❌ YOLOv8l-worldv2 yolov8l-worldv2.pt 객체 탐지 ✅ ✅ ✅ ✅ YOLOv8x-world yolov8x-world.pt 객체 탐지 ✅ ✅ ✅ ❌ YOLOv8x-worldv2 yolov8x-worldv2.pt 객체 탐지 ✅ ✅ ✅ ✅ 공식 결과를 처음부터 재현하려면 데이터 세트를 준비하고 제공된 코드를 사용해 학습을 시작해야 합니다. 학습 절차에는 데이터 딕셔너리를 만들고 사용자 지정 트레이너로
train메서드를 실행하는 과정이 포함됩니다:from ultralytics import YOLOWorld from ultralytics.models.yolo.world.train_world import WorldTrainerFromScratch data = { "train": { "yolo_data": ["Objects365.yaml"], "grounding_data": [ { "img_path": "flickr30k/images", "json_file": "flickr30k/final_flickr_separateGT_train.json", }, { "img_path": "GQA/images", "json_file": "GQA/final_mixed_train_no_coco.json", }, ], }, "val": {"yolo_data": ["lvis.yaml"]}, } model = YOLOWorld("yolov8s-worldv2.yaml") model.train(data=data, batch=128, epochs=100, trainer=WorldTrainerFromScratch)
댓글244
질문을 하거나 결과를 공유하거나 다른 사람을 도와주세요.
IamShubhamGupto
Authors of yolo world released instructions to fine tune their models, would that be supported by ultralytics? if so id like to contribute - https://github.com/AILab-CVC/YOLO-World/blob/master/docs/finetuning.md
5
Paula DerrengerUltralytics(수정됨)@IamShubhamGupto hey there! 👋
Absolutely, we're all for community contributions. Training is supported for YOLO-World models in Ultralytics (we recommend
yolov8*-worldv2.ptfor custom training), see the Train Usage section of the YOLO-World docs:from ultralytics import YOLOWorld model = YOLOWorld("yolov8s-worldv2.pt") model.train(data="coco8.yaml", epochs=100, imgsz=640)If you'd like to add parts of the authors' fine-tuning workflow that aren't covered yet, fork the repo, make your changes, and submit a pull request. Happy coding! 😊👨💻
2woerstcase
If I get you right you thinking in a use like this? https://supervision.roboflow.com/develop/notebooks/zero-shot-object-detection-with-yolo-world/#filtering-detectuions-by-area
Paula DerrengerUltralytics(수정됨)Hey there! 👋
Yes, you're on the right track! The example you've linked from Roboflow demonstrates filtering detections by area, which is indeed supported by Ultralytics YOLO models. You can achieve similar functionality by manipulating the
resultsobject after prediction to filter out detections based on their bounding box area or any other criteria you prefer.Here's a quick example of how you might do that:
from ultralytics import YOLO # Load a pretrained YOLO26 model model = YOLO('yolo26n.pt') # Perform object detection on an image results = model('path/to/image.jpg') # Filter detections by bounding box area (e.g., area > 1000 pixels) filtered_results = [det for det in results[0].boxes.xyxy if (det[2] - det[0]) * (det[3] - det[1]) > 1000] # Do something with filtered_resultsHope this helps! If you have more questions or need further assistance, feel free to ask. Happy coding! 😊🚀
2sbsbsbsbcccc
@IamShubhamGupto嗨呀!👋
当然,我们全力支持社区贡献和对 YOLO-World 等微调模型的支持。如果你有兴趣做出贡献,那就太好了!🌟
请注意,虽然我们支持各种 YOLOv8 任务和模式,但
yolov8*-world.pt目前不支持 YOLO-World 模型 ( ) 的训练模式。不过,您仍然可以使用预先训练的权重进行推理和验证。如果您有与我们现有框架兼容的特定微调流程,我们很乐意看到您的成果!请随意分叉存储库,进行更改,然后提交拉取请求。如果您需要任何帮助或在此过程中有疑问,请随时提出。
祝你编码愉快!😊👨💻
你好,大佬,我想使用mixgrouding数据集和我自己定义的封闭数据集交叉训练,你有具体的mixgrouding数据集配置教程吗data = { "train": { "yolo_data": ["Objects365.yaml"], "grounding_data": [ { "img_path": "../datasets/GQA/images", "json_file": "../datasets/GQA/final_mixed_train_no_coco.json", }, ], }, }
model = YOLOWorld("yolov8s-worldv2.yaml")这几个yaml文件哪里可以找到?
meidachen
Thanks for the great work! I'm wondering which training data has been used for yolov8x-worldv2 model? The model on the official site has "YOLO-Worldv2-X" trained on O365+GoldG+CC3M-Lite, are the training data the same as from here?
2
Glenn JocherUltralytics@meidachen thank you for your kind words! 😊
The YOLOv8x-worldv2 model has indeed been trained on a combination of datasets, specifically Objects365, GoldG, and CC3M-Lite. This diverse training data helps the model excel in open-vocabulary detection tasks by leveraging a wide variety of object categories and contexts.
If you have any further questions or need additional details, feel free to ask. For more information on the YOLO-World model, you can also visit our YOLO-World documentation.
Happy experimenting! 🚀
Dragosjosan
The model performance of the Yolo World Hugging Face model (https://huggingface.co/spaces/stevengrove/YOLO-World) is better for my purpose than the standard inference one "YOLOv8x-worldv2" for example.
Because my lack of domain knowledge regarding this topics I can't make the HF model work on my Mac (not an M processor) so I would like to be able to use the model weights with the abstraction from the ultralytics library.
Is there any way to use the author's provided weights together with the inference library? For example: model = YOLOWorld('yolow-v8_l_clipv2_frozen_t2iv2_bn_o365_goldg_pretrain.pth')
From the author's instruction on how to run the model on an image one needs the configuration file and the weights: https://github.com/AILab-CVC/YOLO-World
The conf file I want to use and the weights are available here: https://huggingface.co/spaces/stevengrove/YOLO-World/blob/main/configs/pretrain/yolo_world_l_t2i_bn_2e-4_100e_4x8gpus_obj365v1_goldg_train_lvis_minival.py https://huggingface.co/spaces/stevengrove/YOLO-World/blob/main/yolow-v8_l_clipv2_frozen_t2iv2_bn_o365_goldg_pretrain.pth
Thank you in advance :)
1
Paula DerrengerUltralytics(수정됨)Hey there! 😊 Thanks for reaching out with your query.
Loading the original authors'
.pthweights and.pyconfig file into Ultralytics isn't supported:YOLOWorld()accepts Ultralytics.ptweights or.yamlmodel files only, and the architectures and weight names differ. Use the weights provided by Ultralytics instead, for exampleyolov8x-worldv2.pt:from ultralytics import YOLOWorld model = YOLOWorld("yolov8x-worldv2.pt") results = model.predict("path/to/image.jpg")Results can differ from the Hugging Face demo because of different weights, preprocessing and settings such as
confandimgsz. If you got any more questions, feel free to ask. 🚀Dragosjosan
Hey @pderrenger,
Thanks your for answering my request! :)
The "8.1.42" ultralytics Version doesn't have an 'config' instance attribute, so I the provided code snippet raises an error.
YOLOWorld.__init__() got an unexpected keyword argument 'config'Do you suppose I'm doing something wrong?
Thanks again 👍
Paula DerrengerUltralytics@Dragosjosan hey there! 😊 It looks like there was a slight misunderstanding regarding model initialization with a 'config' attribute. The
YOLOWorldclass and the way to load pre-trained models or weights with a specific configuration don't directly support an 'config' attribute as part of the initialization process in the Ultralytics YOLOv8's current implementation.For using a model with specific weights, here's the correct approach:
from ultralytics import YOLO # Load the model using pre-trained weights model = YOLO('path/to/your/yolov8s-worldv2.pt') # Example model # Now, you can use this model for inference, training, etc. # Example for inference results = model.predict('path/to/image.jpg') results[0].show()If you're trying to integrate configurations that don't directly map to the pre-trained models provided by Ultralytics, it would usually involve modifying the model's architecture or training process, which is a bit more involved and typically done within the Python scripts or notebooks rather than through the CLI.
I hope this clears things up! If you have any more questions or need further help, feel free to ask. 👍
Dragosjosan
@pderrenger thank you again for your answer.
Since we don't have the expected
model.ptexpected by the YOLO class, is there any way to convert the Hugging Facehf_model.pth?
Paula DerrengerUltralytics(수정됨)Hey @Dragosjosan! 😊
Directly loading or converting external
.pthweights (such as the Hugging Face ones) into the Ultralytics framework isn't supported, since the model architectures and weight naming conventions differ. Please use the weights provided by Ultralytics, for exampleyolov8x-worldv2.pt.Hope this helps! 🚀
Dragosjosan
Hey @pderrenger,
Thank you!
Paula DerrengerUltralyticsHey there! 🌟
Thank you for sharing your interest and enthusiasm! 🚀 To directly address your query, here's a concise example showing how to perform inferential tasks using the pre-trained YOLO-World models with our Python API:
from ultralytics import YOLO # Load a pre-trained YOLO-World model (e.g., yolov8s-worldv2.pt for object detection) model = YOLO('yolov8s-worldv2.pt') # Run inference on an image results = model.predict('path/to/image.jpg') # Visualize and/or process the inference results results[0].show() # Displays the image with detectionsThis snippet loads a YOLO-World model, performs object detection on a specified image, and then visualizes the results. For different tasks or models, simply change the model filename (e.g.,
yolov8m-worldv2.pt).If you're keen on training or further customizing the model, remember that the v2 models (
yolov8*-worldv2.pt) support export for deployment. Just ensure you follow the documentation closely for the best outcomes!Feel free to reach out for more help or share your progress! Happy coding! 😊
tpsvoets
Hey @Dragosjosan, did you have any success getting the .pth file to work? I am not sure why it is suggested to use a config, while that is currently not supported. And I also don't understand the latest reply by @pderrenger?
Dragosjosan
Hi @tpsvoets ,
not with the ultralytics library, no.
Some of the answers might be auto-generated I guess. Long story short: they don't support it. If you want to convert it to .pt you need to figure it out on your own with pytorch and then also adapt this .pt to the ultralytics configuration.
Are you also interested in the topic?
junnnnchi
Hey @Dragosjosan I am also interested in this topic, did you figure out how to convert .pth to .pt?
Dragosjosan
Hey @junnnnchi,
no, sorry. How do you plan on tackling this problem? Maybe we can figure it out together.
tpsvoets
@Dragosjosan ah too bad, it's a shame we cannot get any network file to work with the code. Right now it remains unknown for me how the two demos can differ quite so much. Do we know if the architecture is the same, so if the .pth to .pt conversion works that it will result in something that actually works?
junnnnchi
@Dragosjosan I used the roboflow's implementation for YOLO-World. This version gives better results for my project. You might consider this.
Dragosjosan
@junnnnchi for my application the model from Hugging Face works best... But good that you found something that works. May I ask what your App do? :)
mustfkeskin
Has anyone solved this problem? 🤗
mustfkeskin
How can I integrate the above mentioned files into the ultralytics library. I liked the model results better when working on Huggingface. I noticed that the model size used on Huggingface is a bit bigger size
The conf file I want to use and the weights are available here: https://huggingface.co/spaces/stevengrove/YOLO-World/blob/main/configs/pretrain/yolo_world_l_t2i_bn_2e-4_100e_4x8gpus_obj365v1_goldg_train_lvis_minival.py https://huggingface.co/spaces/stevengrove/YOLO-World/blob/main/yolow-v8_l_clipv2_frozen_t2iv2_bn_o365_goldg_pretrain.pth
Glenn JocherUltralytics@mustfkeskin unfortunately, integrating the specific .pth weights with the Ultralytics library isn't directly supported. You might need to convert the weights to a compatible format like .pt and adjust configurations manually. For further guidance, consider exploring PyTorch documentation or community forums.
-1
venuss920
Hi, guys, if we set and fine-tune our own dataset to fine-tune the model, then while fine-tuning the YOLO-World model, it will also learn text prompts while learning object detection as well?
Paula DerrengerUltralyticsFine-tuning on a standard detection dataset trains YOLO-World to associate visual features with your dataset’s class-name text embeddings; it does not learn arbitrary new prompts as separate annotations or generally train the text encoder. For richer phrase grounding, training requires paired grounding data rather than only YOLO detection labels; see the YOLO-World training reference.
feekyzz
为什么会出现单卡训练跑通train 但是多卡会出现类别和grounding之间不匹配的现象? Why does training run normally on a single GPU, but when using multiple GPUs, there is a mismatch between the nc and the grounding annotations?
Glenn JocherUltralytics多卡下这类
nc与 grounding 标注不匹配通常更像是 DDP 进程读到了不一致的data配置、*.cache或混合安装环境,而不是单纯类别数设置问题;请先确认你是按 YOLO-World 训练示例 使用yolov8*-worldv2和WorldTrainerFromScratch,然后把完整 traceback、你的多卡启动命令,以及ultralytics.utils.checks.collect_system_info()的输出贴在这里,如果最近改过标签或数据集结构,也请先删除labels目录下的*.cache后再试。feekyzz
感谢您的答复,我按照你的建议,删除了*.cache,确认了完全按照示例使用。
这是我的train.py
from ultralytics import YOLOWorld from ultralytics.models.yolo.world.train_world import WorldTrainerFromScratch # Option 1: Use Python dictionary data = dict( train=dict( yolo_data=["/home/qh1/Qwen/Yw/ultralytics-Yw/datasets/Objects365.yaml"], grounding_data=[ dict( img_path="/home/qh1/Qwen/Yw/ultralytics-Yw/datasets/flickr30k/images", json_file="/home/qh1/Qwen/Yw/ultralytics-Yw/datasets/flickr30k/final_flickr_separateGT_train.json", ), dict( img_path="/home/qh1/Qwen/Yw/ultralytics-Yw/datasets/gqa/images", json_file="/home/qh1/Qwen/Yw/ultralytics-Yw/datasets/gqa/final_mixed_train_no_coco.json", ), ], ), val=dict(yolo_data=["/home/qh1/Qwen/Yw/ultralytics-Yw/datasets/lvis.yaml"]), ) model = YOLOWorld("yolov8-worldv2.yaml") model.train( data=data, batch=256, epochs=10, trainer=WorldTrainerFromScratch, workers=16, device=[0,2], name="Base-v8-worldv2", )这是我的训练脚本.sh
#!/bin/bash # Stable RTDETR multi-GPU training script # 设置使用的物理 GPU export CUDA_VISIBLE_DEVICES=0,2 # NCCL / DDP 稳定性环境变量 export NCCL_DEBUG=INFO export NCCL_IB_DISABLE=1 export NCCL_P2P_DISABLE=1 export TORCH_NCCL_BLOCKING_WAIT=1 export TORCH_NCCL_ASYNC_ERROR_HANDLING=1 # 设置随机 master port 避免冲突 PORT=$(shuf -i 25000-30000 -n 1) echo "Using master port: $PORT" # 创建日志文件 LOG_FILE="z-train2-02.log" touch $LOG_FILE # 后台运行训练 nohup python -u z-train2.py \ --device 0 2 \ --master_port $PORT \ > $LOG_FILE 2>&1 & echo "Training started, logging to $LOG_FILE" echo "Use 'tail -f $LOG_FILE' to watch progress"这是我的collect_system_info()输出
Ultralytics 8.3.229 🚀 Python-3.8.20 torch-2.1.0 CUDA:0 (NVIDIA H100 PCIe, 81089MiB) Setup complete ✅ (128 CPUs, 503.5 GB RAM, 3277.3/24934.1 GB disk) OS Linux-6.8.0-101-generic-x86_64-with-glibc2.17 Environment Linux Python 3.8.20 Install pip Path /home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics RAM 503.51 GB Disk 3277.3/24934.1 GB CPU INTEL XEON GOLD 6530 CPU count 128 GPU NVIDIA H100 PCIe, 81089MiB GPU count 8 CUDA 12.1 numpy ✅ 1.24.3>=1.23.0 matplotlib ✅ 3.7.5>=3.3.0 opencv-python ✅ 4.13.0.92>=4.6.0 pillow ✅ 10.4.0>=7.1.2 pyyaml ✅ 6.0.2>=5.3.1 requests ✅ 2.28.2>=2.23.0 scipy ✅ 1.10.1>=1.4.1 torch ✅ 2.1.0>=1.8.0 torch ✅ 2.1.0!=2.4.0,>=1.8.0; sys_platform == "win32" torchvision ✅ 0.16.0>=0.9.0 psutil ✅ 7.2.2>=5.8.0 polars ✅ 1.8.2>=0.20.0 ultralytics-thop ✅ 2.0.18>=2.0.18 {'OS': 'Linux-6.8.0-101-generic-x86_64-with-glibc2.17', 'Environment': 'Linux', 'Python': '3.8.20', 'Install': 'pip', 'Path': '/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics', 'RAM': '503.51 GB', 'Disk': '3277.3/24934.1 GB', 'CPU': 'INTEL XEON GOLD 6530', 'CPU count': 128, 'GPU': 'NVIDIA H100 PCIe, 81089MiB', 'GPU count': 8, 'CUDA': '12.1', 'Package Info': {'numpy': '✅ 1.24.3>=1.23.0', 'matplotlib': '✅ 3.7.5>=3.3.0', 'opencv-python': '✅ 4.13.0.92>=4.6.0', 'pillow': '✅ 10.4.0>=7.1.2', 'pyyaml': '✅ 6.0.2>=5.3.1', 'requests': '✅ 2.28.2>=2.23.0', 'scipy': '✅ 1.10.1>=1.4.1', 'torch': '✅ 2.1.0!=2.4.0,>=1.8.0; sys_platform == "win32"', 'torchvision': '✅ 0.16.0>=0.9.0', 'psutil': '✅ 7.2.2>=5.8.0', 'polars': '✅ 1.8.2>=0.20.0', 'ultralytics-thop': '✅ 2.0.18>=2.0.18'}}这是我的报错日志
Traceback (most recent call last): File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/engine/validator.py", line 227, in __call__ self.loss += model.loss(batch, preds)[1] File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/nn/tasks.py", line 977, in loss return self.criterion(preds, batch) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/loss.py", line 463, in __call__ return self.loss(self.parse_output(preds), batch) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/loss.py", line 468, in loss loss, loss_detach = self.get_assigned_targets_and_loss(preds, batch)[1:] File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/loss.py", line 414, in get_assigned_targets_and_loss _, target_bboxes, target_scores, fg_mask, target_gt_idx = self.assigner( File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/nn/modules/module.py", line 1518, in _wrapped_call_impl return self._call_impl(*args, **kwargs) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/nn/modules/module.py", line 1527, in _call_impl return forward_call(*args, **kwargs) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/utils/_contextlib.py", line 115, in decorate_context return func(*args, **kwargs) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/tal.py", line 98, in forward return self._forward(pd_scores, pd_bboxes, anc_points, gt_labels, gt_bboxes, mask_gt) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/tal.py", line 126, in _forward mask_pos, align_metric, overlaps = self.get_pos_mask( File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/tal.py", line 164, in get_pos_mask align_metric, overlaps = self.get_box_metrics(pd_scores, pd_bboxes, gt_labels, gt_bboxes, mask_in_gts * mask_gt) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/tal.py", line 195, in get_box_metrics bbox_scores[mask_gt] = pd_scores[ind[0], :, ind[1]][mask_gt] # b, max_num_obj, h*w RuntimeError: CUDA error: device-side assert triggered CUDA kernel errors might be asynchronously reported at some other API call, so the stacktrace below might be incorrect. For debugging consider passing CUDA_LAUNCH_BLOCKING=1. Compile with `TORCH_USE_CUDA_DSA` to enable device-side assertions. During handling of the above exception, another exception occurred: Traceback (most recent call last): File "/home/qh1/.config/Ultralytics/DDP/_temp_jzzt2g3g140562231208544.py", line 13, in <module> results = trainer.train() File "/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics/engine/trainer.py", line 246, in train self._do_train() File "/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics/engine/trainer.py", line 520, in _do_train self.metrics, self.fitness = self.validate() File "/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics/engine/trainer.py", line 752, in validate metrics = self.validator(self) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/utils/_contextlib.py", line 115, in decorate_context return func(*args, **kwargs) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/engine/validator.py", line 227, in __call__ self.loss += model.loss(batch, preds)[1] File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/ops.py", line 59, in __exit__ self.dt = self.time() - self.start # delta-time File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/ultralytics/utils/ops.py", line 69, in time torch.cuda.synchronize(self.device) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/cuda/__init__.py", line 783, in synchronize return torch._C._cuda_synchronize() RuntimeError: CUDA error: device-side assert triggered CUDA kernel errors might be asynchronously reported at some other API call, so the stacktrace below might be incorrect. For debugging consider passing CUDA_LAUNCH_BLOCKING=1. Compile with `TORCH_USE_CUDA_DSA` to enable device-side assertions. [E ProcessGroupNCCL.cpp:915] [Rank 1] NCCL watchdog thread terminated with exception: CUDA error: device-side assert triggered CUDA kernel errors might be asynchronously reported at some other API call, so the stacktrace below might be incorrect. For debugging consider passing CUDA_LAUNCH_BLOCKING=1. Compile with `TORCH_USE_CUDA_DSA` to enable device-side assertions. Exception raised from c10_cuda_check_implementation at /opt/conda/conda-bld/pytorch_1695392036766/work/c10/cuda/CUDAException.cpp:44 (most recent call first): frame #0: c10::Error::Error(c10::SourceLocation, std::string) + 0x57 (0x7a2ad6d91617 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libc10.so) frame #1: c10::detail::torchCheckFail(char const*, char const*, unsigned int, std::string const&) + 0x64 (0x7a2ad6d4c98d in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libc10.so) frame #2: c10::cuda::c10_cuda_check_implementation(int, char const*, char const*, int, bool) + 0x118 (0x7a2ada9939f8 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libc10_cuda.so) frame #3: c10d::ProcessGroupNCCL::WorkNCCL::finishedGPUExecutionInternal() const + 0x80 (0x7a2a41b46790 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #4: c10d::ProcessGroupNCCL::WorkNCCL::isCompleted() + 0x58 (0x7a2a41b4a5b8 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #5: c10d::ProcessGroupNCCL::workCleanupLoop() + 0x24b (0x7a2a41b60dfb in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #6: c10d::ProcessGroupNCCL::ncclCommWatchdog() + 0x78 (0x7a2a41b61108 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #7: <unknown function> + 0xdf0e6 (0x7a2ad7c0a0e6 in /home/qh1/Qwen/Yw/yw_env/bin/../lib/libstdc++.so.6) frame #8: <unknown function> + 0x94ac3 (0x7a2af4294ac3 in /lib/x86_64-linux-gnu/libc.so.6) frame #9: <unknown function> + 0x1268d0 (0x7a2af43268d0 in /lib/x86_64-linux-gnu/libc.so.6) terminate called after throwing an instance of 'std::runtime_error' what(): [Rank 1] NCCL watchdog thread terminated with exception: CUDA error: device-side assert triggered CUDA kernel errors might be asynchronously reported at some other API call, so the stacktrace below might be incorrect. For debugging consider passing CUDA_LAUNCH_BLOCKING=1. Compile with `TORCH_USE_CUDA_DSA` to enable device-side assertions. Exception raised from c10_cuda_check_implementation at /opt/conda/conda-bld/pytorch_1695392036766/work/c10/cuda/CUDAException.cpp:44 (most recent call first): frame #0: c10::Error::Error(c10::SourceLocation, std::string) + 0x57 (0x7a2ad6d91617 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libc10.so) frame #1: c10::detail::torchCheckFail(char const*, char const*, unsigned int, std::string const&) + 0x64 (0x7a2ad6d4c98d in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libc10.so) frame #2: c10::cuda::c10_cuda_check_implementation(int, char const*, char const*, int, bool) + 0x118 (0x7a2ada9939f8 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libc10_cuda.so) frame #3: c10d::ProcessGroupNCCL::WorkNCCL::finishedGPUExecutionInternal() const + 0x80 (0x7a2a41b46790 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #4: c10d::ProcessGroupNCCL::WorkNCCL::isCompleted() + 0x58 (0x7a2a41b4a5b8 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #5: c10d::ProcessGroupNCCL::workCleanupLoop() + 0x24b (0x7a2a41b60dfb in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #6: c10d::ProcessGroupNCCL::ncclCommWatchdog() + 0x78 (0x7a2a41b61108 in /home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/lib/libtorch_cuda.so) frame #7: <unknown function> + 0xdf0e6 (0x7a2ad7c0a0e6 in /home/qh1/Qwen/Yw/yw_env/bin/../lib/libstdc++.so.6) frame #8: <unknown function> + 0x94ac3 (0x7a2af4294ac3 in /lib/x86_64-linux-gnu/libc.so.6) frame #9: <unknown function> + 0x1268d0 (0x7a2af43268d0 in /lib/x86_64-linux-gnu/libc.so.6) WARNING ⚠️ CUDA OutOfMemoryError in TaskAlignedAssigner, using CPU [2026-04-21 22:14:56,796] torch.distributed.elastic.multiprocessing.api: [WARNING] Sending process 2677721 closing signal SIGTERM [2026-04-21 22:15:02,669] torch.distributed.elastic.multiprocessing.api: [ERROR] failed (exitcode: -6) local_rank: 1 (pid: 2677722) of binary: /home/qh1/Qwen/Yw/yw_env/bin/python Traceback (most recent call last): File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/runpy.py", line 194, in _run_module_as_main return _run_code(code, main_globals, None, File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/runpy.py", line 87, in _run_code exec(code, run_globals) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/distributed/run.py", line 810, in <module> main() File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/distributed/elastic/multiprocessing/errors/__init__.py", line 346, in wrapper return f(*args, **kwargs) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/distributed/run.py", line 806, in main run(args) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/distributed/run.py", line 797, in run elastic_launch( File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/distributed/launcher/api.py", line 134, in __call__ return launch_agent(self._config, self._entrypoint, list(args)) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/site-packages/torch/distributed/launcher/api.py", line 264, in launch_agent raise ChildFailedError( torch.distributed.elastic.multiprocessing.errors.ChildFailedError: ============================================================ /home/qh1/.config/Ultralytics/DDP/_temp_jzzt2g3g140562231208544.py FAILED ------------------------------------------------------------ Failures: <NO_OTHER_FAILURES> ------------------------------------------------------------ Root Cause (first observed failure): [0]: time : 2026-04-21_22:14:56 host : fusion-G5500-V7 rank : 1 (local_rank: 1) exitcode : -6 (pid: 2677722) error_file: <N/A> traceback : Signal 6 (SIGABRT) received by PID 2677722 ============================================================ Traceback (most recent call last): File "z-train2.py", line 24, in <module> model.train( File "/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics/engine/model.py", line 778, in train self.trainer.train() File "/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics/engine/trainer.py", line 238, in train raise e File "/home/qh1/Qwen/Yw/ultralytics-Yw/ultralytics/engine/trainer.py", line 236, in train subprocess.run(cmd, check=True) File "/home/qh1/Qwen/Yw/yw_env/lib/python3.8/subprocess.py", line 516, in run raise CalledProcessError(retcode, process.args, subprocess.CalledProcessError: Command '['/home/qh1/Qwen/Yw/yw_env/bin/python', '-m', 'torch.distributed.run', '--nproc_per_node', '2', '--master_port', '44421', '/home/qh1/.config/Ultralytics/DDP/_temp_jzzt2g3g140562231208544.py']' returned non-zero exit status 1.
Glenn JocherUltralytics从这份 traceback 看,问题更像是 DDP 子进程混用了本地仓库和
site-packages的ultralytics(trainer.py走的是/ultralytics-Yw/,但validator.py、loss.py、tal.py来自site-packages),再叠加WorldTrainerFromScratch这类自定义组件不适合通过device=[0,2]触发自动 DDP;请按 multi-GPU custom code 说明 直接用torch.distributed.run启动训练脚本、去掉model.train()里的多卡device参数,并先统一成单一安装路径(建议只保留一个环境并用pip install -e .),另外日志里已经出现TaskAlignedAssignerOOM,先把batch=256降下来再复现,这个 OOM 也会连带触发后面的CUDA device-side assert。feekyzz
感谢您的回复,我按照您的设置已经完全解决了训练的问题。 现在有一个小小的问题,batch不能设置太大,不然仍会在val的过程中触发索引不匹配,这个应该就是你说的问题吧“先把 batch=256 降下来再复现,这个 OOM 也会连带触发后面的 CUDA device-side assert”。
Glenn JocherUltralytics是的,这基本就是同一个问题:
val阶段的TaskAlignedAssigner对显存更敏感,大batch先触发 OOM 后,后面的“索引不匹配”或device-side assert通常只是连锁报错;建议把验证批次设得比训练更小,必要时参考 多卡自定义代码训练说明 先训练、再单独用更小batch做val。feekyzz
你好,为什么在训练了30轮左右,val仍停留在0.019左右
Glenn JocherUltralytics如果你现在是用
WorldTrainerFromScratch从头训练,这种情况下 30 个 epoch 左右val还停在较低水平通常并不异常,尤其是用 LVISminival验证时;YOLO-World 从头训练参考 的官方配方本身就是epochs=100,而 训练常见问题 里也提到从头训练会比加载预训练权重收敛更慢。若到 100 个 epoch 后precision、recall和mAP50-95仍几乎不变,再把results.csv、训练曲线和一小份可复现数据贴出来,我们再继续看是否是数据质量或类映射问题。
wcymbnl
你好,我在训练自己的数据集的过程中,采用除了yoloworld以外的模型,精度都非常好。可是,一旦利用预训练权重是yolo-worldv2的模型后,一模一样的数据集,map一直为0。训练的代码也是你们提供的,请问如何解决。
mengdxiran
我也遇到了同样的问题,请问解决了吗?
Glenn JocherUltralytics@faesray Currently the YOLO-World integration only supports the built‑in CLIP text encoder (
ViT-B/32) viabuild_text_model, so swapping in a custom text encoder is not exposed as a config option—you’d need to modifyultralytics.nn.text_model.build_text_modeland retrain, which is a research-level change; for better accuracy with the existing pipeline, use the largeryolov8m/l/x-worldv2backbones rather than relying onsalone, see the model table in the YOLOWorld reference.@yizhihuo99 训练自己数据集时,普通“闭集”微调不需要在
.txt标签或yaml里写整句描述,只要在data.yaml里正确填写names,或在推理时用model.set_classes([...]),训练器会自动根据类别名生成文本特征;只有像文档示例那样用WorldTrainerFromScratch做“检测 + grounding”联合训练时,描述性语言才写在 grounding 的 JSON 里(例如 Flickr30k/GQA 的caption字段),并通过grounding_data传入,而不是放在 YOLO 的txt标签中,具体结构可以参考 WorldTrainerFromScratch 示例.@mgh-man 这里的
nc被硬编码为 80 是刻意设计,它表示“单张图像中最多使用的文本提示数”,而不是数据集的总类别数,所以即使 Objects365 有 365 类,只要一张图里实际出现的不同类别数 ≤ 80,就可以正常训练,不会因为类别 ID > 80 而“无法训练”;目前这个上限只能通过修改WorldTrainer.get_model中的nc=min(self.data["nc"], 80)以及相应模型代码来变更,暂时不支持通过yaml直接把它安全地提高到 365。@wcymbnl @mengdxiran 如果同一数据集在其它模型上 mAP 很高,而换成
yolov8*-worldv2后 mAP 始终为 0,请先确认您是用YOLOWorld类在训练,例如:from ultralytics import YOLOWorld model = YOLOWorld("yolov8s-worldv2.pt") model.train(data="your_dataset.yaml", epochs=100, imgsz=640)然后请检查
your_dataset.yaml中nc是否与names长度一致、标注类别索引是否从 0 连续编号,并在修正后删除标签目录下的*.cache文件再重新训练;如果问题仍在,烦请贴出完整的训练命令、model.train(...)调用和一次完整的日志,以及yolo checks的输出,方便我们进一步定位原因。
mgh-man
Hello, I reproduced the official results from scratch according to the example and found that objects365 has 365 categories, but I cannot set nc to 365. Model. yaml is set to nc=80 during runtime (model. yaml nc=365 with nc=80), which results in images corresponding to categories with indexes exceeding 80 being unable to be trained. I noticed the following explanation in the code:
NOTE: This
nchere is the max number of different text samples in one image, rather than the actualnc.NOTE: Following the official config, nc hard-coded to 80 for now.
So how can I customize the number of nc?
Yangyang875
参考:YOLO-World 模型 - Ultralytics YOLO 文档
Mr.Y @.***
------------------ 原始邮件 ------------------ 发件人: "ultralytics/ultralytics" @.>; 发送时间: 2025年9月6日(星期六) 晚上11:04 @.>; @.@.>; 主题: Re: [ultralytics/ultralytics] zh/models/yolo-world/ (Discussion #8458)
我想问一下,在训练自己的数据集的时候,在哪里添加具有文本描述性的语言,在txt标签文件还是训练时使用的yaml文件
— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: @.***>
yizhihuo99
我想问一下,在训练自己的数据集的时候,在哪里添加具有文本描述性的语言,在txt标签文件还是训练时使用的yaml文件
BorhanPetgar
Hi, thanks for integrating YOLO-World. Is it possible to get the embedding for each bounding box?