यूबंटू पर जेमिनी CLI कैसे इंस्टॉल करें: पूर्ण चरण-दर-चरण ट्यूटोरियल

पूर्व-आवश्यकताएं

Ubuntu पर Gemini CLI स्थापना शुरू करने से पहले, निम्नलिखित तैयार करें:

• Ubuntu संस्करण: 20.04 LTS या नया (22.04, 24.04, और 26.04 पूरी तरह समर्थित हैं)।
• व्यवस्थापकीय पहुंच: पैकेज प्रबंधन के लिए सूडो विशेषाधिकार।
• इंटरनेट कनेक्शन: Node.js, npm पैकेज और प्रमाणीकरण डाउनलोड करने के लिए आवश्यक।
• Google खाता: Gemini मॉडल तक पहुंच के लिए OAuth साइन-इन के लिए आवश्यक।
• अनुशंसित हार्डवेयर: इंटरैक्टिव सत्रों के दौरान सहज प्रदर्शन के लिए कम से कम 4 GB RAM और 2 CPU कोर।

मूल ज्ञान माना गया है: आप जानते हैं कि टर्मिनल कैसे खोलना है और बुनियादी apt और bash आदेश कैसे चलाने हैं।

चरण 1: सिस्टम पैकेज अपडेट करें

निर्भरता संघर्षों को रोकने के लिए अपनी पैकेज सूची को ताज़ा करके और मौजूदा पैकेजों को अपग्रेड करके शुरू करें:

sudo apt update && sudo apt upgrade -y

यह चरण सुनिश्चित करता है कि आपके पास नवीनतम सुरक्षा अपडेट और रिपॉजिटरी जानकारी है।

चरण 2: Node.js 20 या उच्चतर स्थापित करें

Gemini CLI के लिए Node.js संस्करण 20 या नया आवश्यक है। Ubuntu के डिफ़ॉल्ट रिपॉजिटरी में अक्सर पुराने संस्करण शामिल होते हैं (उदाहरण के लिए, Ubuntu 24.04 पर Node 18)।

अनुशंसित विधि: NodeSource रिपॉजिटरी

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

विकल्प: nvm (Node Version Manager) का उपयोग करना

आसान संस्करण प्रबंधन के लिए:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20

स्थापना सत्यापित करें:

node --version
npm --version

आपको Node.js के लिए v20.x.x जैसा और एक मेल खाता npm संस्करण दिखाई देना चाहिए।

चरण 3: Gemini CLI स्थापित करें

वैश्विक स्थापना (दैनिक उपयोग के लिए अनुशंसित)

npm install -g @google/gemini-cli

यह gemini कमांड को पूरे सिस्टम में उपलब्ध कराता है।

स्थायी स्थापना के बिना त्वरित परीक्षण

यदि आप पहले इसे आज़माना चाहते हैं:

npx @google/gemini-cli

उपयोगकर्ता--स्तरीय स्थापना (अनुमति समस्याओं से बचें)

यदि वैश्विक स्थापना के साथ अनुमति त्रुटियां आती हैं:

mkdir -p ~/.local/bin
npm config set prefix '~/.local'
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @google/gemini-cli

चरण 4: स्थापना सत्यापित करें

जांचें कि Gemini CLI सही ढंग से स्थापित है:

gemini --version

अपेक्षित आउटपुट Gemini CLI का वर्तमान संस्करण दिखाता है।

चरण 5: लॉन्च करें और प्रमाणित करें

पहली बार CLI चलाएं:

gemini

टूल आपको Google के साथ साइन इन करने का संकेत देगा। एक ब्राउज़र विंडो स्वचालित रूप से खुल जाएगी। OAuth प्रवाह पूरा करें और टर्मिनल पर वापस आएं।

सफल प्रमाणीकरण के बाद, इंटरैक्टिव Gemini CLI इंटरफ़ेस लोड होता है। उपलब्ध कमांड देखने के लिए /help का उपयोग करें।

सर्वोत्तम अभ्यास: लॉन्च करने से पहले अपनी प्रोजेक्ट निर्देशिका पर नेविगेट करें:

cd ~/my-project
gemini

सामान्य समस्याएँ और समस्या निवारण

• 'gemini: command not found': अपने टर्मिनल को पुनः शुरू करें या source ~/.bashrc चलाएँ। echo $PATH के साथ अपने PATH की जाँच करें।

• npm install के दौरान अनुमति अस्वीकृत: sudo npm के बजाय ऊपर दिए गए उपयोगकर्ता1-स्तरीय स्थापना विधि का उपयोग करें।

• Node.js संस्करण त्रुटि: NodeSource सेटअप को फिर से चलाएँ या nvm के साथ संस्करण बदलें। node --version से पुष्टि करें।

• प्रमाणीकरण विफल: ब्राउज़र पॉप-अप ब्लॉकर्स अक्षम करें, सुनिश्चित करें कि कुकीज़ सक्षम हैं, और पुनः प्रयास करें। यदि आवश्यक हो तो npm कैश साफ़ करें: npm cache clean --force।

• नेटवर्क समय समाप्त या डाउनलोड त्रुटियाँ (जैसे, ripgrep प्रीबिल्ट): स्थिर इंटरनेट सुनिश्चित करें। स्थापना पुनः प्रयास करें या एक वर्कअराउंड के रूप में npx का उपयोग करें।

• निर्माण उपकरण गायब: विकास निर्भरताएँ स्थापित करें:

sudo apt install -y build-essential python3

• WSL-विशिष्ट समस्याएँ: यदि संकलन त्रुटियाँ होती हैं तो WSL के बजाय एक मानक Ubuntu टर्मिनल में आदेश चलाएँ।

अधिक सहायता के लिए, आधिकारिक GitHub रिपॉजिटरी देखें: https://github.com/google-gemini/gemini-cli।

अगले कदम

• मूल आदेशों का पता लगाएँ: CLI के अंदर /help, /model, या /settings टाइप करें।
• परियोजनाओं में उपयोग करें: कोड समझाने, कार्यों को रीफैक्टर करने, या प्राकृतिक भाषा प्रॉम्प्ट्स के साथ नई फ़ाइलें उत्पन्न करने के लिए Gemini से पूछें।
• अनुकूलित करें: थीम, डिफ़ॉल्ट मॉडल और एक्सटेंशन के लिए ~/.config/gemini-cli/ में कॉन्फ़िगरेशन फ़ाइलें संपादित करें।
• नियमित रूप से अद्यतन करें: नवीनतम सुधार प्राप्त करने के लिए npm update -g @google/gemini-cli चलाएँ।
• उपकरणों को एकीकृत करें: गिट एकीकरण जैसे उन्नत एजेंटिक वर्कफ़्लो के लिए अंतर्निहित एक्सटेंशन और MCP सर्वर के साथ प्रयोग करें।

अब आप अपने Ubuntu टर्मिनल में सीधे एक शक्तिशाली AI कोडिंग सहायक के रूप में Gemini CLI का उपयोग करने के लिए तैयार हैं। एक प्रोजेक्ट फ़ोल्डर में सरल प्रॉम्प्ट्स से शुरुआत करें और धीरे-धीरे अधिक जटिल एजेंटिक कार्य बनाएँ।

Gemini के साथ कोडिंग का आनंद लें!