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 দিয়ে এনভায়রনমেন্ট ভেরিয়েবল সেট করুন

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 প্যাকেজে ডিপেন্ডেন্সি অমিল থাকতে পারে, তাই সেগুলো প্রথম পছন্দ হওয়া উচিত নয়।

২০২৬-১০-০৯ তারিখে, এক লাইনের ইনস্টলেশন কমান্ডটি Aider v0.86.2 ইনস্টল করেছে। ইনস্টলেশনের সময় আপনি একটি বার্তা দেখতে পারেন যে ক্যাশে এবং গন্তব্য আলাদা ডিস্কে রয়েছে এবং ফাইলগুলো কপি করা হবে। ইনস্টলেশন তবুও সম্পন্ন হবে।

ইনস্টলেশনের পর, প্রজেক্ট ডিরেক্টরিতে প্রবেশ করুন। একটি সামঞ্জস্যপূর্ণ API হলো এমন একটি ইন্টারফেস যা OpenAI ফরম্যাট ব্যবহার করে অন্যান্য মডেল সার্ভিসের সাথে যোগাযোগ করে। এই প্যাটার্ন ব্যবহার করে Aider শুরু করুন:

aider --model openai/<model-name>

প্রতিস্থাপন করুন <model-name> এর জায়গায় OmniProxy থেকে কপি করা সম্পূর্ণ মডেল আইডি বসান। মডেল আইডি হলো এমন একটি নাম যা একটি মডেলকে সুনির্দিষ্টভাবে শনাক্ত করতে ব্যবহৃত হয়।

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 তালিকা থেকে সম্পূর্ণ মডেলের নাম কপি করুন, মডেল আইডিতে থাকা যেকোনো স্ল্যাশসহ। Aider শুরু করার সময়, যোগ করুন openai/ সম্পূর্ণ আইডির আগে।

২০২৬-১০-০৯ তারিখ অনুযায়ী, প্রোভাইডার ডকুমেন্টেশনে দুটি রেফারেন্স আইডি হলো gemini-3.8-flash এবং grok-4.7। যদি এই নামগুলো বর্তমান তালিকায় না থাকে, তবে সরাসরি সেগুলো কপি করবেন না। তালিকায় থাকা একটি সম্পূর্ণ আইডি ব্যবহার করুন।

ঠিকানা

OPENAI_API_BASE

• এটিকে OmniProxy-এর দিকে নির্দেশ করুন
• /v1 অন্তর্ভুক্ত করুন
• এটিকে রিপোজিটরিতে রাখবেন না

কী

OPENAI_API_KEY

• গেটওয়ে দ্বারা প্রদত্ত কী ব্যবহার করুন
• পরিবর্তনের পর Windows টার্মিনাল পুনরায় খুলুন
• প্রোভাইডার কীগুলো গেটওয়েতে রাখুন

চালু করুন

openai/model

• প্রজেক্ট ডিরেক্টরিতে cd করুন
• মডেল নামের আগে openai/ যোগ করুন
• গেটওয়ে তালিকা থেকে নাম ব্যবহার করুন

টুল কনফিগারেশনে প্রবেশ করুন

আপনাকে আলাদা কোনো কনফিগারেশন ফাইল তৈরি করতে হবে না। প্রজেক্ট ডিরেক্টরিতে প্রবেশ করুন, Aider শুরু করুন এবং মডেল আইডির জায়গায় বর্তমান OmniProxy তালিকায় থাকা একটি নাম বসান:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

অন্য উদাহরণ মডেলটি ব্যবহার করতে, চালান:

aider --model openai/grok-4.7

যখন Aider কোনো অপরিচিত মডেলের সম্মুখীন হয়, তখন এটি একটি সতর্কতা প্রদর্শন করে। এই সতর্কতার মানে এই নয় যে এন্ডপয়েন্টটি ভুল। অনুরোধটি এসেছে কিনা তা নিশ্চিত করতে OmniProxy-এর রিকোয়েস্ট লগ চেক করুন।

Aider শুধুমাত্র Git দ্বারা ট্র্যাক করা ফাইলগুলোই কনটেক্সটে যোগ করে। কনটেক্সট হলো সেই কোড এবং তথ্য যা মডেলটি বর্তমান কাজের সময় পড়তে পারে। যদি বর্তমান ডিরেক্টরি এখনো Git রিপোজিটরি না হয়, তবে Aider একটি তৈরি করে, কিন্তু Git ট্র্যাক করে না এমন ফাইলগুলো তবুও পড়া যায় না। ব্যবহার করুন git add ফাইলগুলো যোগ করতে এবং Aider শুরু করার আগে সেগুলো কমিট করতে।

Aider তবুও ফাইল পরিবর্তন করতে পারে। --no-auto-commits শুধুমাত্র স্বয়ংক্রিয় কমিট নিষ্ক্রিয় করে; এটি ফাইল পরিবর্তন করা আটকায় না। প্রথমবার Aider ব্যবহার করার সময়, একটি গুরুত্বহীন রিপোজিটরি বেছে নিন এবং চালান git diff কাজের পর প্রকৃত পরিবর্তনগুলো পর্যালোচনা করতে।

প্রজেক্ট ফাইল বা পাবলিক পেজে আসল কী রাখবেন না। প্রোভাইডার কীগুলো শুধুমাত্র OmniProxy-তে সংরক্ষণ করুন। যদি গেটওয়ে কী যাচাই না করে, তবে আপনি সেট করতে পারেন OPENAI_API_KEY একটি প্লেসহোল্ডার স্ট্রিং হিসেবে যা শুধুমাত্র আপনার লোকাল কম্পিউটারে ব্যবহৃত হয়।

একটি বাস্তব কাজের মাধ্যমে যাচাই করুন

প্রথমে নিশ্চিত করুন যে আপনি যে ফাইলটি Aider-কে দিয়ে পড়াতে চান তা Git-এ কমিট করা হয়েছে। তারপর প্রজেক্ট ডিরেক্টরি থেকে নিচের কমান্ডটি চালান। মডেল আইডির জায়গায় বর্তমান OmniProxy তালিকা থেকে একটি সম্পূর্ণ আইডি বসান:

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 কমিট তৈরি না করতে বলে।

২০২৬-১০-০৯ তারিখে, Aider v0.86.2 সফলভাবে একটি ট্র্যাক করা ফাইলের প্রথম লাইন পড়েছে। যদি ফাইলটি Git দ্বারা ট্র্যাক করা না হয়, তবে Aider বলবে যে এটি বিষয়বস্তু দেখতে পাচ্ছে না। এর মানে এই নয় যে API এন্ডপয়েন্টটি ভুল। কুয়েরি সম্পন্ন করার পর, অনুরোধের উৎস এবং মডেল আইডি যাচাই করতে OmniProxy-এর রিকোয়েস্ট লগ চেক করুন।

চালু করুন

aider চালু হয়

• কমান্ডটি উপলব্ধ
• এনভায়রনমেন্ট ভেরিয়েবলগুলো সক্রিয়
• প্রজেক্ট ডিরেক্টরিতে

কাজ

এটি ফাইলটি পরিদর্শন করেছে

• নির্দিষ্ট ফাইল সম্পর্কে জিজ্ঞাসা করুন
• এর ব্যাখ্যা পর্যালোচনা করুন
• অপরিচিত মডেল সতর্কতা ট্রিগার করতে পারে

লগ

গেটওয়েতে দৃশ্যমান

• উৎস হলো Aider
• মডেল আইডি মিলেছে
• কীটি পেজে প্রবেশ করানো হয়নি

সাধারণ ত্রুটিসমূহ

• aider পাওয়া যাচ্ছে না: প্রথমে টার্মিনাল পুনরায় খুলুন। যদি আপনি সরাসরি pip দিয়ে ইনস্টল করে থাকেন, তবে চেষ্টা করুন python -m aider।
• ভেরিয়েবল পরিবর্তনের পর Windows এখনো পুরনো এন্ডপয়েন্টে কানেক্ট করছে: আপনাকে অবশ্যই চালানোর পর টার্মিনাল পুনরায় খুলতে হবে setx। শুধুমাত্র একটি নতুন উইন্ডোই আপডেট হওয়া ভেরিয়েবলগুলো পড়বে।
• মডেলের নাম শুরু হয়নি openai/দিয়ে: সামঞ্জস্যপূর্ণ API-এর জন্য ফরম্যাট প্রয়োজন openai/<model-name>।
• অপরিচিত-মডেল সতর্কতা দেখা যাচ্ছে: এটি একটি সাধারণ সতর্কতা এবং এর মানে এই নয় যে কানেকশন ব্যর্থ হয়েছে। OmniProxy অনুরোধটি পেয়েছে কিনা তা চেক করুন।
• মডেল আইডি অবৈধ: বর্তমান OmniProxy তালিকা থেকে সম্পূর্ণ আইডিটি আবার কপি করুন। বজায় রাখুন openai/ প্রিফিক্স এবং আইডিতে ইতিমধ্যে উপস্থিত যেকোনো স্ল্যাশ।
• Aider বলছে কোনো ফাইলের বিষয়বস্তু নেই: নিশ্চিত করুন যে ফাইলটি Git দ্বারা ট্র্যাক করা হয়েছে। একটি খালি রিপোজিটরিতে থাকা ফাইল বা ট্র্যাক না করা ফাইলগুলো কনটেক্সটে যোগ করা হয় না।

অফিসিয়াল রেফারেন্স

ইনস্টলেশন ধাপের জন্য, দেখুন Aider installation। এনভায়রনমেন্ট ভেরিয়েবল এবং মডেল প্রিফিক্সের জন্য, দেখুন OpenAI compatible APIs। উদাহরণ মডেল আইডিগুলো পাওয়া যাবে Gemini model list এবং xAI models page-এ।

আপনার নিজস্ব OmniProxy কনফিগারেশন থেকে প্রতিটি প্লেসহোল্ডার মান দিয়ে প্রতিস্থাপন করুন। কখনোই একটি আসল কি প্রকাশ করবেন না।

একটি সংরক্ষিত ফলাফল বা HTTP 200 নিজে থেকেই এজেন্টের পূর্ণ সামঞ্জস্যতা প্রমাণ করে না। OmniProxy-এর কল লগে উৎস এবং মডেল পরীক্ষা করুন।

অফিশিয়াল উৎস · Aider ↗