Aider کی تنصیب اور OmniProxy کنفیگریشن

Aider ایک ایسا ٹول ہے جو ٹرمینل سے کوڈ میں ترمیم کرنے میں مدد کرتا ہے۔ یہ ماڈل کو بڑے پروجیکٹس کو سمجھنے میں مدد دینے کے لیے پورے کوڈ بیس کا ایک نقشہ تیار کرتا ہے۔ Git ایک ورژن کنٹرول ٹول ہے جو کوڈ کی تبدیلیوں کو ریکارڈ کرتا ہے، جس سے آپ کو فرق دیکھنے اور پچھلے ورژنز کو بحال کرنے کی سہولت ملتی ہے۔ Aider کو کام دینے کے بعد، یہ اسے مرحلہ وار پروسیس کرتا ہے اور کمٹ میسجز لکھتا ہے۔ اگر آپ کو تبدیلیاں پسند نہ آئیں، تو آپ /undo کے ساتھ انہیں واپس (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 کے ساتھ ماحولیاتی متغیرات (environment variables) سیٹ کریں

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 پیکیجز میں انحصار (dependency) کے مسائل ہو سکتے ہیں، اس لیے وہ آپ کی پہلی پسند نہیں ہونے چاہئیں۔

2026-10-09 کو، ایک لائن والی تنصیب کی کمانڈ نے Aider v0.86.2 انسٹال کیا۔ تنصیب کے دوران، آپ کو ایک پیغام نظر آ سکتا ہے کہ کیشے اور منزل مختلف ڈسکس پر ہیں اور فائلیں کاپی کی جائیں گی۔ تنصیب پھر بھی مکمل ہو جائے گی۔

تنصیب کے بعد، پروجیکٹ ڈائریکٹری میں داخل ہوں۔ ایک مطابقت پذیر API (compatible API) وہ انٹرفیس ہے جو OpenAI فارمیٹ کا استعمال کرتے ہوئے دیگر ماڈل سروسز کے ساتھ بات چیت کرتا ہے۔ اس پیٹرن کا استعمال کرتے ہوئے Aider شروع کریں:

aider --model openai/<model-name>

<model-name> کو اگلے سیکشن میں OmniProxy سے کاپی کیے گئے مکمل ماڈل ID سے تبدیل کریں۔ ماڈل ID وہ نام ہے جو کسی ماڈل کی درست شناخت کے لیے استعمال ہوتا ہے۔

OmniProxy سے کنکشن کی ترتیبات حاصل کریں

آپ کو درج ذیل دو ماحولیاتی متغیرات (environment variables) سیٹ کرنے کی ضرورت ہے۔ ماحولیاتی متغیرات کو ٹرمینل پروگراموں کے ذریعے پڑھی جانے والی کنکشن سیٹنگز کے سیٹ کے طور پر سمجھا جا سکتا ہے:

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 تک، پرووائیڈر دستاویزات میں دو حوالہ جاتی IDs 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 installation دیکھیں۔ ماحولیاتی متغیرات اور ماڈل پریفکس کے لیے، OpenAI compatible APIs دیکھیں۔ مثال کے ماڈل IDs Gemini model list اور xAI models page پر مل سکتے ہیں۔

اپنے ذاتی OmniProxy ترتیب سے ہر پلیس ہولڈر کو ویلیوز سے تبدیل کریں۔ کبھی بھی ایک حقیقی کنج شائع نہ کریں۔

محض محفوظ نتیجہ یا HTTP 200 مکمل ایجنٹ مطابقت کی ضمانت نہیں دیتا۔ OmniProxy کی کال ریکارڈ میں ذریعہ اور ماڈل چیک کریں۔

سرکاری ذرائع · Aider ↗