Aider इंस्टॉलेशन और OmniProxy कॉन्फ़िगरेशन
क्या आप कोड बदलने में मदद करने वाला कोई टूल चाहते हैं, लेकिन इस बात से चिंतित हैं कि बदलावों की समीक्षा करना मुश्किल होगा? Aider टर्मिनल में चरण-दर-चरण कार्य करता है और बदलावों को रिकॉर्ड करने के लिए Git का उपयोग करता है, जिससे बदलावों की जांच करना और उन्हें पूर्ववत (undo) करना आसान हो जाता है।
Aider एक ऐसा टूल है जो टर्मिनल से कोड बदलने में मदद करता है। यह बड़े प्रोजेक्ट्स को समझने के लिए मॉडल की सहायता हेतु पूरे कोडबेस का एक मैप बनाता है। Git एक वर्शन कंट्रोल टूल है जो कोड में किए गए बदलावों को रिकॉर्ड करता है, जिससे आप अंतर देख सकते हैं और पिछले वर्शन को रिस्टोर कर सकते हैं। Aider को कोई कार्य देने के बाद, यह उसे चरण-दर-चरण प्रोसेस करता है और कमिट मैसेज लिखता है। यदि आपको बदलाव पसंद नहीं हैं, तो आप उन्हें इस कमांड से पूर्ववत कर सकते हैं: /undo.
शुरू करने से पहले
इंस्टॉलेशन के दो सामान्य विकल्प हैं:
- यदि आपके कंप्यूटर में पहले से Python 3.8 से 3.13 तक मौजूद है, तो इंस्टॉल करें
aider-installसबसे पहले। Python, Aider के लिए आवश्यक रनटाइम एनवायरनमेंट है। - यदि आपके पास उपयुक्त Python वर्शन नहीं है, तो वन-लाइन इंस्टॉलेशन कमांड का उपयोग करें। यह आवश्यकता पड़ने पर Python 3.12 को भी सेटअप कर देगा।
Mac और Linux
install.sh
- curl के बाद sh के साथ चलाएं
- आवश्यकता पड़ने पर Python इंस्टॉल करता है
- यदि curl उपलब्ध न हो तो wget का उपयोग करें
Windows
install.ps1
- PowerShell में चलाएं
- इंस्टॉलेशन के बाद टर्मिनल को फिर से खोलें
- setx के साथ एनवायरनमेंट वेरिएबल्स सेट करें
Python पहले से इंस्टॉल है
aider-install
- पहले इस पैकेज को pip के साथ इंस्टॉल करें
- फिर aider-install चलाएं
- यह अपना खुद का एनवायरनमेंट बनाता है
सुनिश्चित करें कि OmniProxy चल रहा है। इंस्टॉलेशन के बाद, Aider शुरू करने से पहले उस प्रोजेक्ट डायरेक्टरी में जाएं जिसे आप बदलना चाहते हैं।
पहली बार इंस्टॉल और लॉन्च करें
यदि आपके पास पहले से Python 3.8 से 3.13 है
इन कमांड्स को क्रम में चलाएं:
python -m pip install aider-install
aider-install
aider-install Aider को एक अलग Python एनवायरनमेंट में इंस्टॉल करता है ताकि यह आपके कंप्यूटर पर अन्य Python प्रोजेक्ट्स में बाधा न डाले। आवश्यकता पड़ने पर, यह Aider के उपयोग के लिए Python 3.12 भी इंस्टॉल करता है।
वन-लाइन इंस्टॉलेशन
Mac और Linux पर, चलाएं:
curl -LsSf https://aider.chat/install.sh | sh
यदि curl इंस्टॉल नहीं है, तो उपयोग करें:
wget -qO- https://aider.chat/install.sh | sh
Windows PowerShell में, चलाएं:
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
ये वन-लाइन कमांड्स uv पर आधारित हैं, जो Python टूल्स और एनवायरनमेंट को इंस्टॉल और मैनेज करने का एक प्रोग्राम है। आप निम्नलिखित कमांड का भी उपयोग कर सकते हैं:
uv tool install --force --python python3.12 --with pip aider-chat@latest
आप pipx का भी उपयोग कर सकते हैं। जब सीधे python -m pip install aider-chatके साथ इंस्टॉल करते हैं, तो समर्थित Python वर्शन 3.9 से 3.12 हैं। हालाँकि, यह एक वैकल्पिक इंस्टॉलेशन विधि है, इसलिए ऊपर वर्णित विधियों को प्राथमिकता दें। सिस्टम पैकेज मैनेजर से प्राप्त Aider पैकेजों में डिपेंडेंसी बेमेल हो सकती है, इसलिए वे आपकी पहली पसंद नहीं होने चाहिए।
2026-10-09 को, वन-लाइन इंस्टॉलेशन कमांड ने Aider v0.86.2 इंस्टॉल किया। इंस्टॉलेशन के दौरान, आपको एक संदेश दिखाई दे सकता है कि कैश और डेस्टिनेशन अलग-अलग डिस्क पर हैं और फाइलें कॉपी की जाएंगी। इंस्टॉलेशन फिर भी पूरा हो जाएगा।
इंस्टॉलेशन के बाद, प्रोजेक्ट डायरेक्टरी में जाएं। एक संगत (compatible) API एक इंटरफ़ेस है जो OpenAI फॉर्मेट का उपयोग करके अन्य मॉडल सेवाओं के साथ संचार करता है। इस पैटर्न का उपयोग करके Aider शुरू करें:
aider --model openai/<model-name>
बदलें <model-name> को अगले सेक्शन में OmniProxy से कॉपी किए गए पूर्ण मॉडल ID के साथ। मॉडल ID वह नाम है जिसका उपयोग किसी मॉडल की सटीक पहचान के लिए किया जाता है।
OmniProxy से कनेक्शन सेटिंग्स प्राप्त करें
आपको निम्नलिखित दो एनवायरनमेंट वेरिएबल्स सेट करने होंगे। एनवायरनमेंट वेरिएबल्स को टर्मिनल प्रोग्राम द्वारा पढ़ी जाने वाली कनेक्शन सेटिंग्स के सेट के रूप में समझा जा सकता है:
export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>
OPENAI_API_BASE API एंडपॉइंट है और इसमें /v1 शामिल होना चाहिए। OPENAI_API_KEY API तक पहुँचने के लिए उपयोग की जाने वाली कुंजी है।
Windows पर, वेरिएबल्स को सेव करने के लिए setx का उपयोग करें। इसके बाद आपको टर्मिनल को फिर से खोलना होगा:
setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>
वर्तमान OmniProxy सूची से पूरा मॉडल नाम कॉपी करें, जिसमें मॉडल ID में मौजूद कोई भी स्लैश शामिल हो। Aider शुरू करते समय, पूर्ण ID से पहले openai/ जोड़ें।
2026-10-09 तक, प्रदाता दस्तावेज़ीकरण में दो संदर्भ ID gemini-3.8-flash और grok-4.7थे। यदि ये नाम वर्तमान सूची में नहीं हैं, तो उन्हें सीधे कॉपी न करें। सूची में वास्तव में दिखाई देने वाले पूर्ण ID का उपयोग करें।
पता
OPENAI_API_BASE
- इसे OmniProxy की ओर इंगित करें
- /v1 शामिल करें
- इसे रिपॉजिटरी में न रखें
कुंजी
OPENAI_API_KEY
- गेटवे द्वारा प्रदान की गई कुंजी का उपयोग करें
- बदलने के बाद Windows टर्मिनल को फिर से खोलें
- प्रदाता कुंजियों को गेटवे में रखें
लॉन्च
openai/model
- प्रोजेक्ट डायरेक्टरी में cd करें
- मॉडल नाम के आगे openai/ उपसर्ग लगाएं
- गेटवे सूची से नाम का उपयोग करें
टूल कॉन्फ़िगरेशन दर्ज करें
आपको एक अलग कॉन्फ़िगरेशन फाइल बनाने की आवश्यकता नहीं है। प्रोजेक्ट डायरेक्टरी में जाएं, Aider शुरू करें, और मॉडल ID को उस नाम से बदलें जो वर्तमान OmniProxy सूची में वास्तव में मौजूद है:
cd /path/to/your/project
aider --model openai/gemini-3.8-flash
दूसरे उदाहरण मॉडल का उपयोग करने के लिए, चलाएं:
aider --model openai/grok-4.7
जब Aider किसी अपरिचित मॉडल का सामना करता है, तो वह एक चेतावनी प्रदर्शित करता है। इस चेतावनी का मतलब यह नहीं है कि एंडपॉइंट गलत है। यह पुष्टि करने के लिए कि अनुरोध दिखाई दिया या नहीं, OmniProxy के अनुरोध लॉग की जांच करें।
Aider केवल उन फाइलों को संदर्भ (context) में जोड़ता है जिन्हें Git पहले से ट्रैक कर रहा है। संदर्भ वह कोड और जानकारी है जिसे मॉडल वर्तमान कार्य के दौरान पढ़ सकता है। यदि वर्तमान डायरेक्टरी अभी तक Git रिपॉजिटरी नहीं है, तो Aider एक बना देता है, लेकिन जिन फाइलों को Git ट्रैक नहीं करता है, उन्हें अभी भी पढ़ा नहीं जा सकता है। Aider शुरू करने से पहले फाइलों को जोड़ने और कमिट करने के लिए git add का उपयोग करें।
Aider अभी भी फाइलों को संशोधित कर सकता है। --no-auto-commits केवल स्वचालित कमिट को अक्षम करता है; यह फाइल संशोधनों को रोकता नहीं है। पहली बार Aider का उपयोग करते समय, एक महत्वहीन रिपॉजिटरी चुनें और वास्तविक बदलावों की समीक्षा करने के लिए कार्य के बाद git diff चलाएं।
प्रोजेक्ट फाइलों या सार्वजनिक पेजों में वास्तविक कुंजियाँ न रखें। प्रदाता कुंजियों को केवल OmniProxy में स्टोर करें। यदि गेटवे कुंजियों को मान्य नहीं करता है, तो आप OPENAI_API_KEY को केवल अपने स्थानीय कंप्यूटर पर उपयोग किए जाने वाले प्लेसहोल्डर स्ट्रिंग पर सेट कर सकते हैं।
वास्तविक कार्य के साथ सत्यापित करें
सबसे पहले, सुनिश्चित करें कि जिस फाइल को आप Aider से पढ़वाना चाहते हैं, उसे Git में कमिट कर दिया गया है। फिर प्रोजेक्ट डायरेक्टरी से निम्नलिखित कमांड चलाएं। मॉडल ID को वर्तमान OmniProxy सूची के पूर्ण ID से बदलें:
aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits
--message सीधे Aider को एक कार्य भेजता है, जबकि --no-auto-commits Aider को इस रन के दौरान स्वचालित रूप से Git कमिट न बनाने के लिए कहता है।
2026-10-09 को, Aider v0.86.2 ने सफलतापूर्वक एक ट्रैक की गई फाइल की पहली पंक्ति पढ़ी। यदि फाइल Git द्वारा ट्रैक नहीं की गई है, तो Aider कहेगा कि वह सामग्री नहीं देख सकता है। इसका मतलब यह नहीं है कि API एंडपॉइंट गलत है। क्वेरी पूरी करने के बाद, अनुरोध स्रोत और मॉडल ID को सत्यापित करने के लिए OmniProxy के अनुरोध लॉग की जांच करें।
लॉन्च
aider लॉन्च होता है
- कमांड उपलब्ध है
- एनवायरनमेंट वेरिएबल्स सक्रिय हैं
- प्रोजेक्ट डायरेक्टरी में
कार्य
इसने फाइल का निरीक्षण किया
- किसी विशिष्ट फाइल के बारे में पूछें
- इसके स्पष्टीकरण की समीक्षा करें
- अपरिचित मॉडल चेतावनी दे सकते हैं
लॉग
गेटवे में दिखाई देता है
- स्रोत Aider है
- मॉडल ID मेल खाता है
- कुंजी पेज पर दर्ज नहीं की गई थी
सामान्य त्रुटियाँ
aiderनहीं मिल सकता: पहले टर्मिनल को फिर से खोलें। यदि आपने इसे सीधे pip के साथ इंस्टॉल किया है, तो प्रयास करेंpython -m aider.- वेरिएबल्स बदलने के बाद Windows अभी भी पुराने एंडपॉइंट से कनेक्ट होता है: आपको
setxचलाने के बाद टर्मिनल को फिर से खोलना होगा। केवल एक नई विंडो ही अपडेट किए गए वेरिएबल्स को पढ़ेगी। - मॉडल नाम
openai/से शुरू नहीं होता है: संगत API कोopenai/<model-name>फॉर्मेट की आवश्यकता होती है। - अपरिचित-मॉडल चेतावनी दिखाई देती है: यह एक सामान्य चेतावनी है और इसका मतलब यह नहीं है कि कनेक्शन विफल हो गया। जांचें कि क्या OmniProxy को अनुरोध प्राप्त हुआ।
- मॉडल ID अमान्य है: वर्तमान OmniProxy सूची से पूरा ID फिर से कॉपी करें।
openai/उपसर्ग और ID में मौजूद किसी भी स्लैश को बनाए रखें। - Aider कहता है कि कोई फाइल सामग्री नहीं है: सुनिश्चित करें कि फाइल Git द्वारा ट्रैक की गई है। एक खाली रिपॉजिटरी में फाइलें या अनट्रैक की गई फाइलें संदर्भ में नहीं जोड़ी जाती हैं।
आधिकारिक संदर्भ
इंस्टॉलेशन चरणों के लिए, देखें Aider इंस्टॉलेशन। एनवायरनमेंट वेरिएबल्स और मॉडल उपसर्ग के लिए, देखें OpenAI संगत API। उदाहरणों में दिए गए मॉडल ID के लिए Gemini मॉडल सूची और xAI के मॉडल पेज देखें।
अपनी स्वयं की OmniProxy कॉन्फ़िगरेशन से प्रत्येक प्लेसहोल्डर को मान से बदलें। कभी भी एक वास्तविक कुंजी प्रकाशित न करें।
एक सहेजा गया परिणाम या HTTP 200 अकेले पूरी एजेंट संगतता को साबित नहीं करता है। OmniProxy के कॉल रिकॉर्ड में स्रोत और मॉडल जांचें।