CLI संदर्भ

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

---

स्थापना

pip install clore-ai

यह Python SDK और clore CLI कमांड दोनों स्थापित करता है।

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

---

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

अपनी API कुंजी सेट करें

अपनी कुंजी यहाँ से प्राप्त करें Clore.ai डैशबोर्ड → API अनुभाग, फिर कॉन्फ़िगर करें:

clore config set api_key YOUR_API_KEY

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

या पर्यावरण चर का उपयोग करें

export CLORE_API_KEY=your_api_key_here

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

# सभी कॉन्फ़िगरेशन दिखाएँ
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 मार्केटप्लेस में खोज करें।

# सभी उपलब्ध सर्वरों की सूची (मूल्य के अनुसार क्रमबद्ध, शीर्ष 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	पूर्णांक	न्यूनतम GPU संख्या
--min-ram	दशमलव	GB में न्यूनतम RAM
--max-price	दशमलव	USD/घंटा में अधिकतम मूल्य
--sort	विकल्प	इसके अनुसार क्रमबद्ध करें: price (डिफ़ॉल्ट), gpu, ram
--limit	पूर्णांक	दिखाने के लिए अधिकतम परिणाम (डिफ़ॉल्ट: 20)

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

🔍 GPU मार्केटप्लेस
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ आईडी  ┃ GPU                             ┃ संख्या ┃ RAM (GB) ┃ CPU                          ┃ प्रति घंटा मूल्य (USD) ┃ स्थान ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 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 सर्वर किराए पर लेने के लिए एक नया ऑर्डर बनाएँ।

# 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	किराए पर लेने के लिए सर्वर आईडी (यहाँ से प्राप्त करें 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	दशमलव	नहीं	प्रति दिन स्पॉट कीमत (स्पॉट ऑर्डर के लिए आवश्यक)
--gpu-count	पूर्णांक	नहीं	केवल N GPUs किराए पर लें (आंशिक किराया, केवल ऑन-डिमांड)
--gpu-indices	पाठ	नहीं	से कॉमा से अलग किए गए GPU स्लॉट partial_gpu_rental.free_indices (आवश्यक है --gpu-count)

---

clore orders

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

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

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

विकल्प:

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

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

📦 मेरे ऑर्डर
┏━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ आईडी ┃ सर्वर आईडी ┃ प्रकार      ┃ स्थिति ┃ इमेज                             ┃ IP                      ┃
┡━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 38 │ 6         │ on-demand │ सक्रिय │ cloreai/ubuntu22.04-cuda12        │ n1.c1.clorecloud.net    │
└────┴───────────┴───────────┴────────┴───────────────────────────────────┴─────────────────────────┘
कुल: 1 ऑर्डर

---

clore cancel <order_id>

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

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

# समस्या रिपोर्ट के साथ रद्द करें
clore cancel 38 --issue "GPU बहुत ज़्यादा गर्म हो रहा था"

तर्क:

तर्क	विवरण
order_id	रद्द करने के लिए ऑर्डर आईडी

विकल्प:

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

---

clore ssh <order_id>

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

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

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

तर्क:

तर्क	विवरण
order_id	कनेक्ट करने के लिए ऑर्डर आईडी

विकल्प:

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

---

clore wallets

अपने वॉलेट शेष और जमा पते दिखाएँ।

clore wallets

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

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

---

clore servers

मार्केटप्लेस पर आपके द्वारा होस्ट किए जा रहे सर्वरों की सूची दिखाएँ।

clore servers

---

clore server-config <name>

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

clore server-config "MyGPU"

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

सर्वर: MyGPU
आईडी: 42
कनेक्टेड: True
ऑनलाइन: True
दृश्यता: सार्वजनिक
अधिकतम किराया अवधि: 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>

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

clore spot 6

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

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

---

clore spot-price <order_id> <price>

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

clore spot-price 39 0.000003

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

---

clore config

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

# API कुंजी सेट करें
clore config set api_key YOUR_API_KEY

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

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

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

---

वर्कफ़्लो

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

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

# 1. $5/घंटा से कम में RTX 4090 खोजें
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 5

# 2. सबसे सस्ते सर्वर (उदा. आईडी 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 करें (उदा. ऑर्डर आईडी 456)
clore ssh 456

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

किराए पर लेने से पहले शेष राशि की निगरानी करें

# जाँचें कि आपके पास पर्याप्त धन है
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

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

# 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

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

# अपने सर्वर देखें
clore servers

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

---

अगले चरण

• Python SDK — Python के साथ वर्कफ़्लो स्वचालित करें

• REST API — कच्चा API दस्तावेज़ीकरण

• ऑन-डिमांड बनाम स्पॉट — मूल्य निर्धारण मॉडल समझें