# CLI संदर्भ

The `clore` CLI आपको सीधे अपने टर्मिनल से Clore.ai GPU मार्केटप्लेस को प्रबंधित करने देता है — GPU खोजें, इंस्टेंस तैनात करें, SSH करें, और बिना किसी कोड लिखे ऑर्डर प्रबंधित करें।

***

## इंस्टॉलेशन

```bash
pip install clore-ai
```

यह Python SDK और `clore` CLI कमांड दोनों इंस्टॉल करता है।

**आवश्यकताएँ:** Python 3.9+

***

## कॉन्फ़िगरेशन

### अपना API की सेट करें

अपनी कुंजी प्राप्त करें [Clore.ai डैशबोर्ड](https://clore.ai) → **API** सेक्शन, फिर कॉन्फ़िगर करें:

```bash
clore config set api_key YOUR_API_KEY
```

यह कुंजी को यहाँ सहेजता है `~/.clore/config.json`.

### या एक एनवायरनमेंट वेरिएबल का उपयोग करें

```bash
export CLORE_API_KEY=your_api_key_here
```

### वर्तमान कॉन्फ़िग देखें

```bash
# सभी कॉन्फ़िग दिखाएँ
clore config show

# एक विशिष्ट मान प्राप्त करें
clore config get api_key
```

***

## कमांड

| कमांड                                 | विवरण                                      |
| ------------------------------------- | ------------------------------------------ |
| `clore search`                        | GPU मार्केटप्लेस में खोजें                 |
| `clore deploy <server_id>`            | एक नया ऑर्डर बनाएं (सर्वर किराये पर लें)   |
| `clore orders`                        | अपने ऑर्डर्स सूचीबद्ध करें                 |
| `clore cancel <order_id>`             | एक ऑर्डर रद्द करें                         |
| `clore ssh <order_id>`                | एक सक्रिय ऑर्डर में SSH करें               |
| `clore wallets`                       | वॉलेट बैलेंस दिखाएँ                        |
| `clore servers`                       | आपके होस्ट किए गए सर्वरों को सूचीबद्ध करें |
| `clore server-config <name>`          | सर्वर कॉन्फ़िग प्राप्त करें                |
| `clore spot <server_id>`              | किसी सर्वर के लिए स्पॉट मार्केट देखें      |
| `clore spot-price <order_id> <price>` | स्पॉट प्राइस सेट करें                      |
| `clore config set <key> <value>`      | एक कॉन्फ़िग मान सेट करें                   |
| `clore config get <key>`              | एक कॉन्फ़िग मान प्राप्त करें               |
| `clore config show`                   | सभी कॉन्फ़िगरेशन दिखाएँ                    |
| `clore --version`                     | वर्ज़न दिखाएँ                              |

***

## विस्तृत उपयोग

### `clore search`

फ़िल्टर और सॉर्टिंग के साथ GPU मार्केटप्लेस खोजें।

```bash
# सभी उपलब्ध सर्वरों की सूची (कीमत के अनुसार सॉर्ट, शीर्ष 20)
clore search

# GPU मॉडल द्वारा फ़िल्टर करें
clore search --gpu "RTX 4090"

# GPU और अधिकतम कीमत द्वारा फ़िल्टर करें
clore search --gpu "RTX 4090" --max-price 5.0

# मल्टी-GPU रिग्स
clore search --min-gpu 4

# GPU काउंट द्वारा सॉर्ट करें, शीर्ष 10 दिखाएँ
clore search --sort gpu --limit 10

# फ़िल्टर्स को संयोजित करें
clore search --gpu "A100" --min-ram 128 --max-price 10.0 --sort price --limit 5
```

**विकल्प:**

| विकल्प        | टाइप  | विवरण                                                    |
| ------------- | ----- | -------------------------------------------------------- |
| `--gpu`       | पाठ   | GPU मॉडल द्वारा फ़िल्टर करें (उदा. `"RTX 4090"`)         |
| `--min-gpu`   | int   | न्यूनतम GPU संख्या                                       |
| `--min-ram`   | float | GB में न्यूनतम RAM                                       |
| `--max-price` | float | USD/घंटा में अधिकतम कीमत                                 |
| `--sort`      | चॉइस  | इसके अनुसार सॉर्ट करें: `price` (डिफ़ॉल्ट), `gpu`, `ram` |
| `--limit`     | int   | दिखाने के लिए अधिकतम परिणाम (डिफ़ॉल्ट: 20)               |

**उदाहरण आउटपुट:**

```
🔍 GPU मार्केटप्लेस
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ID  ┃ GPU                             ┃ Count ┃ RAM (GB) ┃ CPU                          ┃ Price/h (USD) ┃ Location ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 123 │ 1x NVIDIA GeForce RTX 4090      │     1 │    64.0  │ AMD Ryzen 9 5900X            │       $0.3200 │ US       │
│ 456 │ 2x NVIDIA GeForce RTX 4090      │     2 │   128.0  │ Intel Core i9-13900K         │       $0.5800 │ DE       │
└─────┴─────────────────────────────────┴───────┴──────────┴──────────────────────────────┴───────────────┴──────────┘
2 सर्वर दिखा रहे हैं
```

***

### `clore deploy <server_id>`

GPU सर्वर किराये पर लेने के लिए एक नया ऑर्डर बनाएं।

```bash
# ऑन-डिमांड ऑर्डर SSH के साथ
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MySecurePass123 \
  --port 22:tcp \
  --port 8888:http

# स्पॉट ऑर्डर
clore deploy 123 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --port 22:tcp

# एनवायरनमेंट वेरिएबल्स के साथ
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MyPass123 \
  --port 22:tcp \
  --env WANDB_API_KEY=your_key \
  --env HF_TOKEN=your_token
```

**आर्ग्यूमेंट्स:**

| आर्ग्यूमेंट | विवरण                                                        |
| ----------- | ------------------------------------------------------------ |
| `server_id` | किराये पर लेने के लिए सर्वर ID (प्राप्त करें `clore search`) |

**विकल्प:**

| विकल्प           | टाइप  | आवश्यक | विवरण                                                     |
| ---------------- | ----- | ------ | --------------------------------------------------------- |
| `--image`        | पाठ   | हाँ    | Docker इमेज (उदा. `cloreai/ubuntu22.04-cuda12`)           |
| `--type`         | चॉइस  | हाँ    | `on-demand` या `spot`                                     |
| `--currency`     | पाठ   | हाँ    | भुगतान मुद्रा (उदा. `bitcoin`)                            |
| `--ssh-password` | पाठ   | नहीं   | SSH पासवर्ड (अल्फ़ान्यूमेरिक, अधिकतम 32 वर्ण)             |
| `--ssh-key`      | पाठ   | नहीं   | SSH पब्लिक की                                             |
| `--port`         | पाठ   | नहीं   | पोर्ट मैपिंग (दोहराने योग्य), प्रारूप: `PORT:PROTOCOL`    |
| `--env`          | पाठ   | नहीं   | एनवायरनमेंट वेरिएबल (दोहराने योग्य), प्रारूप: `KEY=VALUE` |
| `--spot-price`   | float | नहीं   | प्रति दिन स्पॉट प्राइस (स्पॉट ऑर्डर्स के लिए आवश्यक)      |

***

### `clore orders`

अपने सक्रिय ऑर्डर्स सूचीबद्ध करें।

```bash
# सक्रिय ऑर्डर्स
clore orders

# पूर्ण/समाप्त ऑर्डर्स शामिल करें
clore orders --completed
```

**विकल्प:**

| विकल्प        | विवरण                           |
| ------------- | ------------------------------- |
| `--completed` | पूर्ण/समाप्त ऑर्डर्स शामिल करें |

**उदाहरण आउटपुट:**

```
📦 मेरे ऑर्डर्स
┏━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ Server ID ┃ Type      ┃ Status ┃ Image                             ┃ IP                      ┃
┡━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 38 │ 6         │ on-demand │ Active │ cloreai/ubuntu22.04-cuda12        │ n1.c1.clorecloud.net    │
└────┴───────────┴───────────┴────────┴───────────────────────────────────┴─────────────────────────┘
कुल: 1 ऑर्डर
```

***

### `clore cancel <order_id>`

एक सक्रिय ऑर्डर रद्द करें।

```bash
# ऑर्डर रद्द करें
clore cancel 38

# समस्या रिपोर्ट के साथ रद्द करें
clore cancel 38 --issue "GPU was overheating"
```

**आर्ग्यूमेंट्स:**

| आर्ग्यूमेंट | विवरण                     |
| ----------- | ------------------------- |
| `order_id`  | रद्द करने के लिए ऑर्डर ID |

**विकल्प:**

| विकल्प    | विवरण                              |
| --------- | ---------------------------------- |
| `--issue` | रद्द करने का कारण / समस्या रिपोर्ट |

***

### `clore ssh <order_id>`

चल रहे ऑर्डर में SSH के माध्यम से ऑटो-कनेक्ट। CLI आपके ऑर्डर विवरण से होस्टनाम और पोर्ट हल कर देता है।

```bash
# root के रूप में कनेक्ट करें (डिफ़ॉल्ट)
clore ssh 38

# किसी अन्य उपयोगकर्ता के रूप में कनेक्ट करें
clore ssh 38 --user ubuntu
```

**आर्ग्यूमेंट्स:**

| आर्ग्यूमेंट | विवरण                       |
| ----------- | --------------------------- |
| `order_id`  | कनेक्ट करने के लिए ऑर्डर ID |

**विकल्प:**

| विकल्प   | डिफ़ॉल्ट | विवरण              |
| -------- | -------- | ------------------ |
| `--user` | `root`   | SSH उपयोगकर्ता नाम |

***

### `clore wallets`

अपने वॉलेट बैलेंस और डिपॉज़िट पतों को दिखाएँ।

```bash
clore wallets
```

**उदाहरण आउटपुट:**

```
💰 वॉलेट बैलेंस
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ मुद्रा             ┃ बैलेंस       ┃ डिपॉज़िट पता                              ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ bitcoin          │ 0.00153176   │ tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr │
│ CLORE-Blockchain │ 150.00000000 │ cLr1q8x...                                │
└──────────────────┴──────────────┴───────────────────────────────────────────┘
```

***

### `clore servers`

उन सर्वरों की सूची बनाएं जिन्हें आप मार्केटप्लेस पर होस्ट कर रहे हैं।

```bash
clore servers
```

***

### `clore server-config <name>`

किसी विशिष्ट सर्वर की कॉन्फ़िगरेशन प्राप्त करें जिसे आप होस्ट करते हैं।

```bash
clore server-config "MyGPU"
```

**उदाहरण आउटपुट:**

```
सर्वर: MyGPU
ID: 42
कनेक्टेड: True
ऑनलाइन: True
दिखावट: public
न्यूनतम रेंटल अवधि: 72
GPUs: NVIDIA GeForce RTX 4090
ऑन-डिमांड कीमत (USD): $0.35
स्पॉट कीमत (USD): $0.18
CPU: AMD Ryzen 9 5900X 12-Core Processor
RAM: 64.0 GB
GPU: 1x NVIDIA GeForce RTX 4090
```

***

### `clore spot <server_id>`

किसी सर्वर के लिए वर्तमान स्पॉट मार्केट ऑफ़र्स देखें।

```bash
clore spot 6
```

**उदाहरण आउटपुट:**

```
📊 स्पॉट मार्केट - सर्वर 6
┏━━━━━━━━━━┳━━━━━━━━━━━┓
┃ ऑर्डर ID ┃ कीमत      ┃
┡━━━━━━━━━━╇━━━━━━━━━━━┩
│ 39       │ 4.2e-06   │
└──────────┴───────────┘
```

***

### `clore spot-price <order_id> <price>`

अपने स्पॉट मार्केट ऑफर पर कीमत अपडेट करें।

```bash
clore spot-price 39 0.000003
```

> **नोट:** आप स्पॉट कीमतों को केवल हर 600 सेकंड में एक बार कम कर सकते हैं, और यह एक सीमित कदम आकार द्वारा ही संभव है।

***

### `clore config`

CLI कॉन्फ़िगरेशन प्रबंधित करें।

```bash
# API की सेट करें
clore config set api_key YOUR_API_KEY

# एक मान प्राप्त करें
clore config get api_key

# सभी कॉन्फ़िग दिखाएँ
clore config show
```

कॉन्फ़िगरेशन में सहेजी जाती है `~/.clore/config.json`.

***

## वर्कफ़्लोज़

### खोज → किराए पर लें → SSH → रद्द करें

एक सामान्य एंड-टू-एंड वर्कफ़्लो:

```bash
# 1. $5/घंटा से कम में RTX 4090 ढूँढें
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 5

# 2. सबसे सस्ते सर्वर पर तैनात करें (जैसे ID 123)
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MyPass123 \
  --port 22:tcp \
  --port 8888:http

# 3. अपने ऑर्डर की स्थिति जांचें
clore orders

# 4. इंस्टेंस में SSH करें (जैसे ऑर्डर ID 456)
clore ssh 456

# 5. काम पूरा होने पर, ऑर्डर रद्द करें
clore cancel 456
```

### किराये पर लेने से पहले बैलेंस की निगरानी करें

```bash
# जाँचें कि आपके पास पर्याप्त धन है
clore wallets

# खोजें और किराये पर लें
clore search --gpu "A100" --sort price --limit 3
clore deploy 789 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password SecurePass \
  --port 22:tcp
```

### स्पॉट मार्केट वर्कफ़्लो

```bash
# 1. किसी सर्वर के लिए स्पॉट ऑफ़र्स जांचें
clore spot 6

# 2. एक स्पॉट ऑर्डर बनाएं
clore deploy 6 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --ssh-password MyPass123 \
  --port 22:tcp

# 3. अपनी स्पॉट कीमत समायोजित करें
clore spot-price 39 0.000003
```

### सर्वर होस्टिंग प्रबंधन

```bash
# अपने सर्वरों को देखें
clore servers

# किसी सर्वर की कॉन्फ़िग जांचें
clore server-config "MyGPU"
```

***

## अगले चरण

* [**Python SDK**](/clore.ai/clore.ai-eng-hi/developers/python-sdk.md) — Python के साथ वर्कफ़्लो स्वचालित करें
* [**REST API**](/clore.ai/clore.ai-eng-hi/for-hosts/api.md) — कच्ची API दस्तावेज़ीकरण
* [**ऑन-डिमांड बनाम स्पॉट**](/clore.ai/clore.ai-eng-hi/for-renters/on-demand-vs-spot.md) — मूल्य निर्धारण मॉडलों को समझें


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-hi/developers/cli-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
