የ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"

እነዚህ የአንድ መስመር ትዕዛዞች የተመሰረቱት የPython መሳሪያዎችን እና አካባቢዎችን ለመጫን እና ለማስተዳደር በፕሮግራም በሆነው uv ላይ ነው። የሚከተለውን ትዕዛዝ መጠቀምም ይችላሉ:

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 ን ጭኗል። በሚጫንበት ጊዜ፣ መሸጎጫው (cache) እና መድረሻው በተለያዩ ዲስኮች ላይ እንደሆኑ እና ፋይሎች እንደሚገለበጡ የሚገልጽ መልእክት ሊያዩ ይችላሉ። መጫኑ አሁንም ይጠናቀቃል።

ከተጫነ በኋላ፣ የፕሮጀክት ማውጫውን ያስገቡ። ተኳሃኝ የሆነ API ከሌሎች ሞዴል አገልግሎቶች ጋር በOpenAI ቅርጸት የሚገናኝ በይነገጽ ነው። Aider ን በዚህ ንድፍ ይጀምሩ:

aider --model openai/<model-name>

ይተኩ <model-name> በሚቀጥለው ክፍል ከOmniProxy በተገለበጠው ሙሉ የሞዴል መታወቂያ (ID)። የሞዴል መታወቂያ ሞዴልን በትክክል ለመለየት የሚያገለግል ስም ነው።

ከOmniProxy የግንኙነት ቅንብሮችን ያግኙ

የሚከተሉትን ሁለት የአካባቢ ተለዋዋጮች ማዘጋጀት ያስፈልግዎታል። የአካባቢ ተለዋዋጮች በተርሚናል ፕሮግራሞች የሚነበቡ የግንኙነት ቅንብሮች ስብስብ ተደርገው ሊወሰዱ ይችላሉ:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE የAPI መድረሻ ነጥብ (endpoint) ነው እና /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 ዝርዝር ይቅዱ፣ በሞዴል መታወቂያ ውስጥ ያሉ ማናቸውንም ሰያፍ መስመሮች (slashes) ጨምሮ። Aider ን ሲጀምሩ፣ ያክሉ openai/ ከሙሉ መታወቂያው በፊት።

እ.ኤ.አ. በ2026-10-09፣ በአቅራቢው ሰነድ ውስጥ ያሉት ሁለቱ የማጣቀሻ መታወቂያዎች ነበሩ gemini-3.8-flash እና grok-4.7። እነዚህ ስሞች በአሁኑ ዝርዝር ውስጥ ከሌሉ፣ በቀጥታ አይቅዱዋቸው። በዝርዝሩ ውስጥ በእርግጥ የሚታይ ሙሉ መታወቂያ ይጠቀሙ።

አድራሻ

OPENAI_API_BASE

• ወደ OmniProxy ይጠቁሙት
• /v1 ያካትቱ
• በማጠራቀሚያው (repository) ውስጥ አያስቀምጡት

ቁልፍ

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 ጥያቄ ምዝግብ ማስታወሻዎችን (logs) ያረጋግጡ።

Aider በGit የተከታተሉ ፋይሎችን ብቻ ወደ አውድ (context) ይጨምራል። አውድ ማለት ሞዴሉ አሁን ባለው ስራ ወቅት ሊያነበው የሚችለው ኮድ እና መረጃ ነው። የአሁኑ ማውጫ ገና የGit ማጠራቀሚያ ካልሆነ፣ Aider አንዱን ይፈጥራል፣ ነገር ግን Git የማይከታተላቸው ፋይሎች አሁንም ሊነበቡ አይችሉም። ይጠቀሙ git add ፋይሎቹን ለመጨመር እና Aider ከመጀመርዎ በፊት ለመፈጸም (commit)።

Aider አሁንም ፋይሎችን ማስተካከል ይችላል። --no-auto-commits ራስ-ሰር ኮሚቶችን ብቻ ያሰናክላል; የፋይል ማሻሻያዎችን አይከላከልም። Aider ን ለመጀመሪያ ጊዜ ሲጠቀሙ፣ አስፈላጊ ያልሆነ ማጠራቀሚያ ይምረጡ እና ያሂዱ git diff ስራው ከተጠናቀቀ በኋላ ትክክለኛዎቹን ለውጦች ለመገምገም

እውነተኛ ቁልፎችን በፕሮጀክት ፋይሎች ወይም በይፋዊ ገጾች ውስጥ አያስቀምጡ። የአቅራቢ ቁልፎችን በOmniProxy ውስጥ ብቻ ያከማቹ። ጌትዌይ ቁልፎችን ካላረጋገጠ፣ ማዘጋጀት ይችላሉ OPENAI_API_KEY በአካባቢዎ ኮምፒውተር ላይ ብቻ ጥቅም ላይ ለሚውል ቦታ ያዥ (placeholder) ሕብረቁምፊ።

በእውነተኛ ስራ ያረጋግጡ

በመጀመሪያ፣ Aider እንዲያነበው የሚፈልጉት ፋይል ወደ Git መፈጸሙን (committed) ያረጋግጡ። ከዚያ ከፕሮጀክት ማውጫው የሚከተለውን ትዕዛዝ ያሂዱ። የሞዴል መታወቂያውን ከአሁኑ የ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 ኮሚቶችን እንዳይፈጥር ይነግረዋል።

እ.ኤ.አ. በ2026-10-09፣ Aider v0.86.2 የተከታተለ ፋይል የመጀመሪያ መስመር በተሳካ ሁኔታ አንብቧል። ፋይሉ በGit ካልተከታተለ፣ Aider ይዘቱን ማየት እንደማይችል ይናገራል። ይህ ማለት የAPI መድረሻ ነጥቡ የተሳሳተ ነው ማለት አይደለም። ጥያቄውን ከጨረሱ በኋላ፣ የጥያቄውን ምንጭ እና የሞዴል መታወቂያ ለማረጋገጥ የOmniProxy ጥያቄ ምዝግብ ማስታወሻዎችን ያረጋግጡ።

ማስጀመሪያ

aider ይጀምራል

• ትዕዛዝ ይገኛል
• የአካባቢ ተለዋዋጮች ንቁ ናቸው
• በፕሮጀክት ማውጫ ውስጥ

ስራ

ፋይሉን መርምሯል

• ስለ አንድ የተወሰነ ፋይል ይጠይቁ
• ማብራሪያውን ይገምግሙ
• ያልተለመዱ ሞዴሎች ማስጠንቀቂያ ሊያስነሱ ይችላሉ

ምዝግብ ማስታወሻዎች (Logs)

በጌትዌይ ውስጥ ይታያል

• ምንጩ 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 ላይ ሊገኙ ይችላሉ.

እያንዳንዱን የቦታ ያዥ (placeholder) በራስዎ የ OmniProxy ውቅር እሴቶች ይተኩ። እውነተኛ ቁልፍን በጭራሽ አያትሙ።

የተቀመጠ ውጤት ወይም HTTP 200 ብቻውን ሙሉ የAgent ተኳኋኝነትን አያረጋግጥም። በ OmniProxy የጥያቄ መዝገብ ውስጥ ምንጩን እና ሞዴሉን ያረጋግጡ።

ኦፊሴላዊ ምንጮች · Aider ↗