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

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 کے ساتھ ماحول کے متغیرات (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 وہ کلید (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 کے درخواست لاگز (request logs) چیک کریں۔

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 مطابقت پذیر APIs دیکھیں۔ مثال کے ماڈل IDs Gemini ماڈل لسٹ اور xAI ماڈلز صفحہ پر مل سکتے ہیں۔

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

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

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