Installazzjoni ta’ Aider u konfigurazzjoni ma’ OmniProxy

Aider huwa għodda li tgħinek timmodifika l-kodiċi mit-terminal. Joħloq mappa tal-codebase kollu biex jgħin lill-mudell jifhem proġetti akbar; Git huwa għodda ta’ kontroll tal-verżjonijiet li tirreġistra l-bidliet fil-kodiċi u tista’ tintuża biex tara d-differenzi u treġġa’ lura l-modifiki. Meta tagħti kompitu lil Aider, dan jipproċessah pass pass u jikteb messaġġ tal-commit. Jekk ma jogħġbokx ir-riżultat, tista’ tuża /undo biex treġġgħu lura.

Tħejjija qabel l-installazzjoni

Hemm żewġ metodi komuni ta’ installazzjoni:

Jekk il-kompjuter diġà għandu Python minn 3.8 sa 3.13: l-ewwel installa aider-install. Python huwa l-ambjent meħtieġ biex jaħdem Aider.
Jekk m’għandekx verżjoni xierqa ta’ Python: uża l-kmand ta’ installazzjoni b’linja waħda, li jħejji wkoll Python 3.12 jekk ikun meħtieġ.

Mac u Linux

install.sh

Ħaddmu b'sh wara curl
Jinstalla Python meta jkun meħtieġ
Jista' jintuża wget jekk curl mhuwiex disponibbli

Windows

install.ps1

Ħaddmu b'PowerShell
Erġa' iftaħ it-terminal wara l-installazzjoni
Uża setx għall-varjabbli tal-ambjent

Diġà għandek Python

aider-install

L-ewwel installa dan il-pakkett b'pip
Imbagħad ħaddem aider-install
Joħloq l-ambjent tiegħu stess

L-installazzjoni b’linja waħda tħejji Python 3.12 jekk ikun meħtieġ. L-installazzjoni diretta ta’ aider-chat permezz ta’ pip hija inqas affidabbli.

Ħejji OmniProxy u kun żgur li qed jaħdem. Wara l-installazzjoni, l-ewwel idħol fid-direttorju tal-proġett li trid timmodifika, imbagħad ibda Aider.

Installazzjoni u l-ewwel tħaddim

Jekk diġà għandek Python minn 3.8 sa 3.13

Ħaddem dawn il-kmandi wara xulxin:

python -m pip install aider-install
aider-install

aider-install jinstalla Aider f’ambjent Python separat, biex ma jitħallatx ma’ proġetti Python oħra fuq il-kompjuter. Jekk ikun meħtieġ, jinstalla wkoll Python 3.12 biex jintuża minn Aider.

Installazzjoni b’linja waħda

Fuq Mac u Linux, ħaddem:

curl -LsSf https://aider.chat/install.sh | sh

Jekk il-kompjuter m’għandux curl, tista’ tuża dan minflok:

wget -qO- https://aider.chat/install.sh | sh

Fuq Windows PowerShell, ħaddem:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Dawn il-kmandi b’linja waħda huma bbażati fuq uv; uv huwa programm għall-installazzjoni u l-ġestjoni ta’ għodod u ambjenti Python. Tista’ tuża wkoll il-kmand li ġej:

uv tool install --force --python python3.12 --with pip aider-chat@latest

Tista’ tuża wkoll pipx. Meta tinstalla direttament permezz ta’ python -m pip install aider-chat, il-verżjonijiet appoġġjati ta’ Python huma minn 3.9 sa 3.12, iżda dan jitqies bħala metodu alternattiv ta’ installazzjoni; ippreferi l-metodi ta’ qabel. Aider mill-package managers tas-sistema jista’ jkollu dipendenzi li ma jaqblux, għalhekk tużahomx bħala l-ewwel għażla għall-installazzjoni.

Fit-2026-10-09, il-kmand ta’ installazzjoni b’linja waħda installa Aider v0.86.2. Jekk waqt l-installazzjoni jidher avviż li l-cache u d-destinazzjoni mhumiex fuq l-istess diska u li l-fajls se jiġu kkupjati minflok, l-installazzjoni xorta titlesta.

Wara li tintemm l-installazzjoni, idħol fid-direttorju tal-proġett. Interfaċċa kompatibbli hija interfaċċa li tuża l-format OpenAI biex tikkomunika ma’ servizzi ta’ mudelli oħra. Il-format tat-tħaddim huwa dan:

aider --model openai/<model-name>

Ibdel <model-name> bl-ID sħiħ tal-mudell ikkupjat minn OmniProxy fit-taqsima li jmiss; l-ID tal-mudell huwa l-isem li jidentifika l-mudell b’mod preċiż.

Ikseb il-parametri tal-konnessjoni minn OmniProxy

Trid tissettja ż-żewġ varjabbli tal-ambjent li ġejjin. Il-varjabbli tal-ambjent jistgħu jitqiesu bħala sett ta’ konfigurazzjonijiet tal-konnessjoni li jaqra programm tat-terminal:

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

OPENAI_API_BASE huwa l-indirizz tal-interfaċċa u jrid jinkludi /v1. OPENAI_API_KEY hija ċ-ċavetta użata biex taċċessa l-interfaċċa.

Fuq Windows, uża setx biex issalva l-varjabbli. Wara li tħaddmu, trid terġa’ tiftaħ it-terminal:

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

Ikkopja l-isem sħiħ tal-mudell mil-lista attwali ta’ OmniProxy, inklużi s-slashes fl-ID tal-mudell. Meta tibda Aider, żid openai/ qabel l-ID sħiħ.

Fit-2026-10-09, iż-żewġ IDs ta’ referenza fid-dokumentazzjoni tal-fornituri kienu gemini-3.8-flash u grok-4.7. Jekk dawn l-ismijiet ma jkunux fil-lista attwali, tikkopjahomx direttament; uża l-ID sħiħ li effettivament jidher fil-lista.

Indirizz

OPENAI_API_BASE

Jipponta lejn OmniProxy
Spiċċah b'/v1
Tiktbux fir-repożitorju

Ċavetta

OPENAI_API_KEY

Uża ċ-ċavetta li bagħtitlek il-gateway
Fuq Windows, erġa' iftaħ it-terminal wara l-bidla
Ħalli ċ-ċavetta tal-fornitur fil-gateway

Tnedija

openai/mudell

Uża cd biex tidħol fid-direttorju tal-proġett
Żid openai/ mal-isem tal-mudell
Uża l-isem mil-lista tal-gateway

Iż-żewġ varjabbli tal-ambjent flimkien ma’ isem tal-mudell bil-prefiss openai/ jiffurmaw il-format tal-interfaċċa kompatibbli.

Daħħal il-konfigurazzjoni tal-għodda

M’hemmx għalfejn toħloq fajl ta’ konfigurazzjoni separat. L-ewwel idħol fid-direttorju tal-proġett, imbagħad ibda Aider u ibdel l-ID tal-mudell b’isem li effettivament jinsab fil-lista attwali ta’ OmniProxy:

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

Biex taqleb għall-mudell l-ieħor tal-eżempju, ħaddem:

aider --model openai/grok-4.7

Meta Aider jiltaqa’ ma’ mudell li ma jagħrafx, l-interfaċċa turi twissija. Din it-twissija waħedha ma tfissirx li l-indirizz huwa żbaljat; iċċekkja r-reġistru tat-talbiet ta’ OmniProxy biex tikkonferma jekk it-talba waslitx.

Aider ipoġġi fil-kuntest biss fajls li diġà huma traċċati minn Git; il-kuntest huwa l-kodiċi u l-informazzjoni li l-mudell jista’ jaqra matul il-kompitu attwali. Jekk id-direttorju attwali għadu mhuwiex repożitorju Git, Aider joħloq wieħed awtomatikament, iżda xorta ma jkunx jista’ jaqra fajls li mhumiex traċċati minn Git. L-ewwel żid il-fajls b’git add u agħmel commit, imbagħad ibda Aider.

Aider xorta jista’ jimmodifika l-fajls. --no-auto-commits jitfi biss il-commits awtomatiċi; ma jwaqqafx il-modifika tal-fajls. Għall-ewwel użu, huwa rakkomandat li tagħżel repożitorju mhux importanti u, wara li jintemm il-kompitu, tħaddem git diff biex tara l-bidliet effettivi.

Tiktibx ċwievet reali fil-fajls tal-proġett jew f’paġni pubbliċi. Żomm iċ-ċwievet tal-fornitur f’OmniProxy biss. Jekk il-gateway ma jivverifikax iċ-ċavetta, tista’ ddaħħal f’OPENAI_API_KEY sensiela ta’ karattri fittizja li tintuża lokalment biss.

Ivverifika b’kompitu reali

L-ewwel ikkonferma li l-fajl li trid jinqara diġà ġie committed f’Git, imbagħad ħaddem il-kmand li ġej fid-direttorju tal-proġett. L-ID tal-mudell irid jinbidel bl-ID sħiħ mil-lista attwali ta’ OmniProxy:

aider --model openai/gemini-3.8-flash --message "X’inhi l-ewwel linja ta’ dan il-fajl? Timmodifikax il-fajl." --no-auto-commits

--message jintuża biex jagħti kompitu direttament lil Aider, filwaqt li --no-auto-commits ifisser li matul din it-tħaddima m’għandux jinħoloq commit Git awtomatikament.

Fit-2026-10-09, Aider v0.86.2 intuża biex jaqra l-ewwel linja ta’ fajl traċċat. Jekk il-fajl għadu mhux traċċat minn Git, Aider iwieġeb li ma jistax jara l-kontenut; dan ma jfissirx li l-indirizz tal-interfaċċa huwa żbaljat. Wara l-mistoqsija, iċċekkja r-reġistru tat-talbiet ta’ OmniProxy biex tivverifika s-sors tat-talba u l-ID tal-mudell.

Tnedija

aider jista' jinfetaħ

Il-kmand jinstab
Il-varjabbli tal-ambjent daħlu fis-seħħ
Qiegħed fid-direttorju tal-proġett

Kompitu

Ħares lejn il-fajl

Staqsi dwar fajl speċifiku
Ara l-ispjegazzjoni tiegħu
Jidher avviż għal mudell mhux magħruf

Reġistru

Jidher fil-gateway

Is-sors huwa Aider
L-ID tal-mudell jaqbel
Iċ-ċavetta ma daħlitx fil-paġna

Kun żgur li l-varjabbli tal-ambjent daħlu fis-seħħ u li l-kmand jinstab, imbagħad wettaq mistoqsija reali.

Żbalji komuni

aider ma jinstabx: l-ewwel erġa’ iftaħ it-terminal. Jekk użajt pip biex tinstallah direttament, tista’ tipprova python -m aider.
Fuq Windows għad hemm konnessjoni mal-indirizz l-antik wara li bdilt il-varjabbli: wara li tħaddem setx, trid terġa’ tiftaħ it-terminal. It-tieqa l-ġdida biss taqra l-varjabbli aġġornati.
M’hemmx openai/ qabel l-isem tal-mudell: l-interfaċċa kompatibbli teħtieġ il-format openai/<model-name>.
Tidher twissija dwar mudell mhux magħruf: din hija twissija normali u ma tfissirx li l-konnessjoni falliet. Imbagħad iċċekkja jekk OmniProxy rċeviex it-talba.
L-ID tal-mudell mhuwiex validu: erġa’ kkopja l-ID sħiħ mil-lista attwali ta’ OmniProxy, filwaqt li żżomm il-prefiss openai/ u s-slashes oriġinali fl-ID.
Jgħid li m’hemmx kontenut tal-fajl: l-ewwel ikkonferma li l-fajl huwa traċċat minn Git. Repożitorju vojt jew fajls mhux traċċati ma jidħlux fil-kuntest.

Referenzi uffiċjali

Għall-passi tal-installazzjoni, ara Aider installation. Għall-varjabbli tal-ambjent u l-prefiss tal-mudell, ara OpenAI compatible APIs. L-IDs tal-mudelli użati fl-eżempji jinsabu fil-lista tal-mudelli Gemini u fil-paġna tal-mudelli xAI.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · Aider ↗