You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

327 lines
34 KiB

---
comments: true
description: Ultralytics कित करनििन तर। Ultralytics क pip, conda, git और Docker क उपयग करकित कर। Ultralytics क उपयग कमड लइन इटरफस य अपन Python परिजनतर करन
keywords: Ultralytics सपन, pip install Ultralytics, Docker install Ultralytics, Ultralytics कमड लइन इटरफस, Ultralytics Python इटरफ
---
## Ultralytics सित कर
Ultralytics न pip, conda और Docker सहित कई सपनििरदन क। नवनतम सिर सकरण कि`ultralytics` pip पज क उपयग करक YOLOv8 सित कर सबस अदयतित सकरण किए [Ultralytics GitHub repository](https://github.com/ultralytics/ultralytics) कन कर। Docker क उपयग करक, सय सपन बच कर, एक छ जगह मज क नए सकरण किदन कि सकत
!!! Note "नट"
🚧 हम बहय दसकरण क वरतमन मिन ह और हम उसरनिए कठिनत पर कम कर रह। आपकय किए धनयवद! 🙏
!!! Example "सित कर"
=== "Pip सित कर (अनित)"
यदि आपकस पिछलकरण कपन, तिप क उपयग करक `ultralytics`ज कित करनि`pip install -U ultralytics` कमड चल`ultralytics`ज क अधिक विवरण किए [Python Package Index (PyPI)](https://pypi.org/project/ultralytics/) पर ज
[![PyPI version](https://badge.fury.io/py/ultralytics.svg)](https://badge.fury.io/py/ultralytics) [![Downloads](https://static.pepy.tech/badge/ultralytics)](https://pepy.tech/project/ultralytics)
```bash
# PyPI स ultralytics पज कपन कर
pip install ultralytics
```
आप इस [GitHub repository](https://github.com/ultralytics/ultralytics) सित कर सकत। यह अदयतन सकरण पत करनहत यह सरतम ह सकत। इसकिए अपनिटम पर गिट कमड-लइन टल सित हिए। `@main` अपदश क `main`ित करत और इससर, उद. `@my-branch`, मित कि सकत, यणत हटि सकत, ति यह डिट रप स `main`ए।
```bash
# GitHub स ultralytics पज कपन कर
pip install git+https://github.com/ultralytics/ultralytics.git@main
```
=== "Conda सित कर"
पनिए pip क बदल Conda एक वकलिक पज परबधक हि आप सपनिए उपयग कर सकत। किनकिए [Anaconda कय सइट](https://anaconda.org/conda-forge/ultralytics) पर ज। कज क अदयतन और सधन रििए [यह](https://github.com/conda-forge/ultralytics-feedstock/) द
[![Conda Recipe](https://img.shields.io/badge/recipe-ultralytics-green.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Version](https://img.shields.io/conda/vn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics) [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/ultralytics.svg)](https://anaconda.org/conda-forge/ultralytics)
```bash
# conda क उपयग करक ultralytics पज कपन कर
conda install -c conda-forge ultralytics
```
!!! Note "नट"
यदि आप CUDA परिश मित कर रह सरतम अनि आप कमड-लइन पर `pytorch` और `pytorch-cuda`ित करनिए कमड एक सथ इल करिज परबधक कई भ टकरव सलझिए अनमतिि, यिर जररत पड पर CPU-विि`pytorch`ज क CPU-वििट ह `pytorch-cuda`ज क अधिित करन अनमति
```bash
# conda क उपयग करक सभ एक सथ सित कर
conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics
```
### Conda Docker इम
Ultralytics Conda Docker इमज [DockerHub](https://hub.docker.com/r/ultralytics/ultralytics) स उपलबध ह। य इमज [Miniconda3](https://docs.conda.io/projects/miniconda/en/latest/) पर आधित ह और `ultralytics` उपयग Conda परवरण म करनिए एक सरल तर
```bash
# रपरम क एक चर कप मट कर
t=ultralytics/ultralytics:latest-conda
# Docker Hub स नवनतम ultralytics इमज कल कर
sudo docker pull $t
# ज समरथन वनर म ultralytics इमज चल
sudo docker run -it --ipc=host --gpus all $t # सभ
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # जििट कर
```
=== "Git कन"
यदि आप विस मगदन करनि रखत नवनतम सत कड कथ परयग करन इच रखत, त `ultralytics`ििटरन कर। किग कद, उस नििित सदरभ मिट कर और पज क पहचननिए pip क उपयग करतए सगठनमक म`-e`थ पज सित कर
```bash
# ultralytics रििटरन कर
git clone https://github.com/ultralytics/ultralytics
# कन क गई निििट कर
cd ultralytics
# विस किए सगठनमक मड मज सित कर
pip install -e .
```
=== "Docker"
Docker क उपयग करक `ultralytics`ज क आसिदन कर और इस रखरखव महद सगम बन, इस पज क उपयग कर, वििन परवरण पर सतत और सगम परदरशन सिित करनिए। [Docker Hub](https://hub.docker.com/r/ultralytics/ultralytics) स सतित कयकवरण तक पहच किए Ultralytics 5 मय समरित Docker इमज उपलबध ह, जििन पटफम और उपयग ममलिए उचच सगतत और परदथशलतरदन करनिए डिइन किए गए ह:
<a href="https://hub.docker.com/r/ultralytics/ultralytics"><img src="https://img.shields.io/docker/pulls/ultralytics/ultralytics?logo=docker" alt="डकर पस"></a>
- **Dockerfile:** परशिषण किए अदयतन सकरण किए अनित GPU चिर।
- **Dockerfile-arm64:** ARM64 वििकरण किए अनित, Raspberry Pi और अनय ARM64 आधित पटफम पर यत क अनमति
- **Dockerfile-cpu:** GPU रहित पतलडल, उब आधित ययत तक पनरिण किए उपयत ह
- **Dockerfile-jetson:** NVIDIA Jetson उपकरणिए आदर आधर पर ग समरथन मिन, इन पटफिए अनल य समरथन समित करत
- **Dockerfile-python:** कवल Python और आवशयकतरतिित करननतम छवि, हल ऐपस और विस किए आदरश छवि
- **Dockerfile-conda:** Miniconda3 पर आधित, Ultralytics पज कपनथ।
िनलिित कम उपयग करक नवनतम छवि और उसिित कर:
```bash
# छविम क एक चर कप मट कर
t=ultralytics/ultralytics:latest
# Docker Hub स नवनतम ultralytics छविल कर
sudo docker pull $t
# ज समरथन वनर म ultralytics छवि चल
sudo docker run -it --ipc=host --gpus all $t # सभ
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # जििट कर
```
उपरत कमड न एक Docker कनर क एकस करनिए उतन कि`-it`झट एक परतक TTY किित करत और stdin ख रखत, जिसस आप कनर कथ इटरट कर सकत`--ipc=host`झट IPC (Inter-Process Communication) नमसस कट पर सट करत, जरकिच म करनिए आवशयक ह`--gpus all`ििट जनर कतर सभ उपलबध जिए पहच सकषम करत, ज हसतकप आवशयकतिए महतवपण ह
न द: कनर मिि अपनय मशन पर फइलथ कम करनिए Docker वम क उपयग कर:
```bash
# सय नििनर मििट कर
sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container $t
```
`/path/on/host` अपनय मशन पर निि पथ कथ बदल और `/path/in/container`नर मयत तक पथ बदलिसस पहच मिल सक
ण Docker उपयग किए, आप [Ultralytics Docker मगदरि](https://docs.ultralytics.com/guides/docker-quickstart/) क अनषण कर सकत
`ultralytics`िए सभ आवशयकति`ultralytics` [requirements.txt](https://github.com/ultralytics/ultralytics/blob/main/requirements.txt) फइल द। धन दि उपरत सभ उदहरण सभ आवशयकतित ह
<p align="center">
<br>
<iframe width="720" height="405" src="https://www.youtube.com/embed/_a7cVL9hqnk"
title="YouTube वियर" frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
allowfullscreen>
</iframe>
<br>
<strong>:</strong> Ultralytics YOLO Quick Start Guide
</p>
!!! Tip "सव"
ऑपरिग सिटम और CUDA आवशयकत अनर PyTorch आवशयकत अलग-अलग ह सकत, इसलिए अनि पहल PyTorch सित करनिए इरकस पर ज। [https://pytorch.org/get-started/locally](https://pytorch.org/get-started/locally) पर उपयग क अधिक जनकिए।
<a href="https://pytorch.org/get-started/locally/">
<img width="800" alt="PyTorch Installation Instructions" src="https://user-images.githubusercontent.com/26833433/228650108-ab0ec98a-b328-4f40-a40d-95355e8a84e3.png">
</a>
## CLI कथ Ultralytics क उपयग कर
Ultralytics कमड लइन इटरफस (CLI) आसन एकल-पि कमड किए सप मसल अदयतित करत, पयथन परवरण करत कि। CLI कई अनलन ययथन कड क आवशयकत नह। आप कवल `yolo` कमड कथ टरिनल स सभ चल सकत। CLI स YOLOv8 क उपयग करन और अधिक जननिए [CLI Guide](/../usage/cli.md) द
!!! Example "उदहरण"
=== "सजन"
Ultralytics `yolo` कमड क उपयग निनलिित पप क उपयग करत:
```bash
yolo टक मड ARGS
```
- `टक` (वकलिक) इनम एक ह ([ख](tasks/detect.md), [](tasks/segment.md), [वरकरण कर](tasks/classify.md), [िि](tasks/pose.md))
- `मड` (आवशयक) इनम एक ह ([परशिषण](modes/train.md), [](modes/val.md), [](modes/predict.md), [ि](modes/export.md), [](modes/track.md))
- `ARGS` (वकलिक) `imgsz=640` `arg=मन`िट क ओवररइड करत
सभ `ARGS`ण [Configuration Guide](/../usage/cfg.md) य `yolo cfg` CLI कमड कथ द
=== "परशिषण"
िक शिषण और language कथ 10 एपस किए एक डिशन मडल परशिित कर, जह
ििषण दर 0.01 ह
```bash
yolo टन data=coco128.yaml model=yolov8n.pt epochs=10 lr0=0.01
```
=== "पन"
व-परशिित सगमशन मडल क उपयग करक YouTube वि भवियव कर
छवि आकर 320:
```bash
yolo पन model=yolov8n-seg.pt सत='https://youtu.be/LNwODJXcvt4' imgsz=320
```
=== "मय कर"
एक पव-परशिित डिशन मडल कयतरमित कर और इमज क आकर 640 कच-आकर 1 कथ द:
```bash
yolo मय model=yolov8n.pt data=coco128.yaml batch=1 imgsz=640
```
=== "नित कर"
एक YOLOv8n वरकरण मडल क ONNX पप मित कर, 224x224 क आकर पर छवि (कई टक आवशयक नह)
```bash
yolo नित model=yolov8n-cls.pt format=onnx imgsz=224,128
```
=== "विष"
ट कम चलिकरण, सिग द, चक कर और अधिक द:
```bash
yolo help
yolo checks
yolo version
yolo settings
yolo copy-cfg
yolo cfg
```
!!! Warning "चवन"
िि न ह, तजिग क `arg=val`प मर करन, जि `=`िित कि और जच अतरित ह`--` तरक-पवक अ शबद य `,`तरल द तर उपयग न कर
- `yolo predict model=yolov8n.pt imgsz=640 conf=0.25`
- `yolo predict model yolov8n.pt imgsz 640 conf 0.25` ❌ (अभ`=`)
- `yolo predict model=yolov8n.pt, imgsz=640, conf=0.25` ❌ (`,` उपयग न कर)
- `yolo predict --model yolov8n.pt --imgsz 640 --conf 0.25` ❌ (`--` उपयग न कर)
एकय ययत [Configuration Guide](/../usage/cfg.md) य `yolo cfg` CLI कमड कथ द
## Python कथ Ultralytics क उपयग कर
YOLOv8 क Python इटरफस आपक Python परिजनित मिलनिए एक आसन तकनक परदन करत, जि हमस शिल करन आसन ह। उपयगकर उनक परिजन आपतकन पहच, चल और मडल क आउटपट करसकरण करन आसथ परशतर, खड, और वरकरण किए सिजनक मय परदन करत। इस तकनक कथ, उपयगकरिए यह अदिय सधन ह अपन Python परिजन इन गिल करन इच रखत
उदहरण किए, उपयगकरिनतिए कछ-कछ तरणजनडल कड करक उसरशिित कर सकत, इसककन समत कर सकत और यदि आवशयक ह, उस ONNX पप मित कर सकत। अपन Python परिजन YOLOv8 क उपयग करन और अधिक जननिए [Python Guide](/../usage/python.md) द
!!! Example "उदहरण"
```python
from ultralytics import YOLO
# प नई YOLO मडल बन
model = YOLO('yolov8n.yaml')
# परशिित YOLO मडल लड कर (परशिषण किए अनित ह)
model = YOLO('yolov8n.pt')
# 3 एपस किए "coco128.yaml" डट क उपयग करकडल करशिित कर
results = model.train(data='coco128.yaml', epochs=3)
# मडल कयतट पर परदरशन कर
results = model.val()
# मडल क उपयग करक छवि पर डिशन कर
results = model('https://ultralytics.com/images/bus.jpg')
# मडल क ONNX पप मित कर
success = model.export(format='onnx')
```
[Python Guide](/../usage/python.md){.md-button .md-button--primary}
## Ultralytics सि
Ultralytics लइबिस परबधन परणरदन करति आप अपनरय पर फइन-गड निरण बनए रख सक`ultralytics.utils`ि`SettingsManager` उपयग करक उपयगकर अपनिस तक पहच करक उन पढ और बदल सकत। इनयथन परवरण कतर सखन और सित करनिए, य CLI (कमड लइन इटरफस) कयम सि सकत
### सिस क गणन
अपनिस किस क ओरद करनिए आप उनख सकत:
!!! Example "सिस द"
=== "पयथन"
आप PyTorch स `ultralytics`ल म `सिस` ऑबट क आयत करक अपनिस दख सकत`settings` ऑबट पर पिट और रिटरन सिस किए निनलिित कम उपयग कर:
```python
from ultralytics import settings
# सभिस द
print(settings)
# एक विष सिग पत कर
value = settings['runs_dir']
```
=== "CLI"
यदि आप पथमिकत CLI क उपयग करन पसद करत, तिनलिित कमड कयम स अपनिस कच कर सकत:
```bash
yolo settings
```
### सिस सित करन
Ultralytics किस कित करन आसन ह। बदलिन तरि सकत:
!!! Example "सिस अपडट कर"
=== "पयथन"
यथन परवरण कतर, अपनिस पर `अपडट`ििकर अपनिस क बदल सकत:
```python
from ultralytics import settings
# एक सिग अपडट कर
settings.update({'runs_dir': '/path/to/runs'})
# एकिक सिग अपडट कर
settings.update({'runs_dir': '/path/to/runs', 'tensorboard': False})
# डिट मन मिग रट कर
settings.reset()
```
=== "CLI"
यदि आप कमड लइन इटरफस पर धन द, तिनलिित कमड कयम स अपनिस कित कर सकत:
```bash
# एक सिग अपडट कर
yolo settings runs_dir='/path/to/runs'
# एकिक सिग अपडट कर
yolo settings runs_dir='/path/to/runs' tensorboard=False
# डिट मन मिस क बरबरट कर
yolo settings reset
```
### सिस क समझन
िनलिित टबल सिस क अवलकन परदन करत, जबकिरतििस किए उदहरण मन, डरकर और सप मिवरण दि गय
| नम | उदहरण मन | डरकर | विवरण |
|--------------------|-----------------------|-------------|----------------------------------------------------------------------------------------------------------------------------|
| `settings_version` | `'0.0.4'` | `str` | Ultralytics _settings_करण (Ultralytics [pip](https://pypi.org/project/ultralytics/) सकरण स अलग ह) |
| `datasets_dir` | `'/path/to/datasets'` | `str` | डट करहत करनिि | |
| `weights_dir` | `'/path/to/weights'` | `str` | मडल वट करहत करनिि |
| `runs_dir` | `'/path/to/runs'` | `str` | परयग दरहत करनिि |
| `uuid` | `'a1b2c3d4'` | `str` | मिस किए अदिय पहचनकर |
| `sync` | `True` | `bool` | Ultralytics और दि HUB म समकन रख |
| `api_key` | `''` | `str` | Ultralytics HUB [API Key](https://hub.ultralytics.com/settings?tab=api+keys) |
| `clearml` | `True` | `bool` | ClearML लिग क उपयग कर |
| `comet` | `True` | `bool` | यदि [Comet ML](https://bit.ly/yolov8-readme-comet) परयग कर नह experiment टिग और visualization |
| `dvc` | `True` | `bool` | शध और सकरण निरण किए [DVC for experiment tracking](https://dvc.org/doc/dvclive/ml-frameworks/yolo) क उपयग कर |
| `hub` | `True` | `bool` | [Ultralytics HUB](https://hub.ultralytics.com) एककरण क उपयग कर |
| `mlflow` | `True` | `bool` | एकसपिट टिग किए MLFlow क उपयग कर |
| `neptune` | `True` | `bool` | एकसपिट टिग किए Neptune क उपयग कर |
| `raytune` | `True` | `bool` | hyperparameter tuning किए Ray Tune क उपयग कर |
| `tensorboard` | `True` | `bool` | विअलइजशन किए TensorBoard क उपयग कर |
| `wandb` | `True` | `bool` | Weights & Biases logging क उपयग कर |
जब आप अपन परिजन अनयम स चलत करत, त इन सिस पर सर करनिए ल