# 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 ` | एक नया ऑर्डर बनाएं (सर्वर किराये पर लें) | | `clore orders` | अपने ऑर्डर्स सूचीबद्ध करें | | `clore cancel ` | एक ऑर्डर रद्द करें | | `clore ssh ` | एक सक्रिय ऑर्डर में SSH करें | | `clore wallets` | वॉलेट बैलेंस दिखाएँ | | `clore servers` | आपके होस्ट किए गए सर्वरों को सूचीबद्ध करें | | `clore server-config ` | सर्वर कॉन्फ़िग प्राप्त करें | | `clore spot ` | किसी सर्वर के लिए स्पॉट मार्केट देखें | | `clore spot-price ` | स्पॉट प्राइस सेट करें | | `clore config set ` | एक कॉन्फ़िग मान सेट करें | | `clore config get ` | एक कॉन्फ़िग मान प्राप्त करें | | `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 ` 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 ` एक सक्रिय ऑर्डर रद्द करें। ```bash # ऑर्डर रद्द करें clore cancel 38 # समस्या रिपोर्ट के साथ रद्द करें clore cancel 38 --issue "GPU was overheating" ``` **आर्ग्यूमेंट्स:** | आर्ग्यूमेंट | विवरण | | ----------- | ------------------------- | | `order_id` | रद्द करने के लिए ऑर्डर ID | **विकल्प:** | विकल्प | विवरण | | --------- | ---------------------------------- | | `--issue` | रद्द करने का कारण / समस्या रिपोर्ट | *** ### `clore ssh ` चल रहे ऑर्डर में 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 ` किसी विशिष्ट सर्वर की कॉन्फ़िगरेशन प्राप्त करें जिसे आप होस्ट करते हैं। ```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 ` किसी सर्वर के लिए वर्तमान स्पॉट मार्केट ऑफ़र्स देखें। ```bash clore spot 6 ``` **उदाहरण आउटपुट:** ``` 📊 स्पॉट मार्केट - सर्वर 6 ┏━━━━━━━━━━┳━━━━━━━━━━━┓ ┃ ऑर्डर ID ┃ कीमत ┃ ┡━━━━━━━━━━╇━━━━━━━━━━━┩ │ 39 │ 4.2e-06 │ └──────────┴───────────┘ ``` *** ### `clore spot-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**](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/developers/python-sdk) — Python के साथ वर्कफ़्लो स्वचालित करें * [**REST API**](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-hosts/api) — कच्ची API दस्तावेज़ीकरण * [**ऑन-डिमांड बनाम स्पॉट**](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-renters/on-demand-vs-spot) — मूल्य निर्धारण मॉडलों को समझें