Pi መጫን እና OmniProxy ማዋቀር

Pi ትንሽ የተርሚናል ረዳት ነው—በመስመር ትዕዛዝ (command line) በቀጥታ ከእርስዎ ጋር የሚያወራ፣ ፋይሎችን የሚያነብ እና ስራዎችን የሚያጠናቅቅ ፕሮግራም። አጭር የስርዓት ጥያቄ (system prompt) አለው እና በነባሪነት ጥቂት መሳሪያዎች ብቻ አሉት። ሌሎች ትዕዛዞች፣ የስራ ፍሰቶች ወይም በይነገጾች ከፈለጉ፣ በኋላ በቅጥያዎች (extensions) በኩል ማከል ይችላሉ። ቅጥያዎች ለ Pi ችሎታዎችን የሚጨምሩ አካላት ናቸው፣ እና ከፈጠሩ በኋላ ከሌሎች ጋር ማጋራት ይችላሉ።

ንዑስ ወኪሎች (subagents) የስራውን ክፍል ለሌላ ረዳት ይሰጣሉ፣ እቅድ ሁነታ (plan mode) ደግሞ አፈፃፀሙ ከመጀመሩ በፊት እርምጃዎችን ያደራጃል። አንዳቸውም ባህሪ በነባሪነት አልተካተቱም፣ ነገር ግን Pi እንዲገነባቸው መጠየቅ ወይም በሌሎች የተጋሩ ጥቅሎችን መጫን ይችላሉ።

ከመጀመርዎ በፊት

macOS እና Linux የመጫኛ ስክሪፕት ይጠቀማሉ—Piን በራስ-ሰር የሚያወርድ እና የሚጭን አንድ ትዕዛዝ። በዊንዶውስ ላይ፣ በ Pi መነሻ ገጽ ላይ የቀረበውን የ PowerShell ትዕዛዝ ይጠቀሙ። PowerShell በዊንዶውስ ውስጥ የተካተተ የመስመር ትዕዛዝ አካባቢ ነው። እንዲሁም Piን በ WSL ውስጥ መጫን ይችላሉ፣ በዊንዶውስ ውስጥ የሚገኘው የሊኑክስ አካባቢ።

በ npm ለመጫን ከመረጡ፣ Node.js 22.19 ወይም ከዚያ በላይ ያስፈልግዎታል። npm ከ Node.js ጋር ጥቅም ላይ የሚውል የጥቅል አስተዳዳሪ ነው እና Piን ከመስመር ትዕዛዝ መጫን ይችላል።

macOS Linux

install.sh

• ኦፊሴላዊውን ስክሪፕት curl ያድርጉ
• ጫኚው ጥገኞቹን (dependencies) ይሰካል
• በ pi update ያዘምኑ

Windows

install.ps1

• ኦፊሴላዊ የ PowerShell ትዕዛዝ
• Git for Windows ባሽ (Bash) ያቀርባል
• እንዲሁም WSL መጠቀም ይችላሉ

Node ቀድሞ ተጭኗል

npm

• Node 22.19+ ያስፈልገዋል
• የጥቅል ስሙ pi-coding-agent ነው
• --ignore-scripts ያክሉ

Piን ለመጀመሪያ ጊዜ መጫን እና ማስጀመር

በ macOS ወይም Linux ላይ፣ ተርሚናል ይክፈቱ እና ያሂዱ:

curl -fsSL https://pi.dev/install.sh | sh

በዊንዶውስ ላይ፣ PowerShell ይክፈቱ እና ያሂዱ:

powershell -c "irm https://pi.dev/install.ps1 | iex"

Node.js 22.19 ወይም ከዚያ በላይ ቀድሞውኑ ከተጫነ፣ ከፈጣን ጅምር አማራጭ ትዕዛዙን መጠቀም ይችላሉ:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

የመጫኛ ስክሪፕቱ በይነተገናኝ ተርሚናል ውስጥ ጥያቄዎችን ለመጠየቅ ሊያቆም ይችላል። ለመቀጠል በስክሪኑ ላይ ያሉትን ጥያቄዎች ይከተሉ። ቀድሞውኑ ተኳሃኝ የሆነ የNode ስሪት ካለዎት፣ ይህ የ npm ትዕዛዝ ጥያቄዎችን አይጠይቅም። Piን በሌላ ማውጫ ውስጥ ለመጫን፣ ያክሉ --prefix /your/directory። በ2026-10-09፣ ይህ Pi 1.1.0ን ጭኗል።

መደበኛ የ npm ጭነት የጥቅል የህይወት ዑደት ስክሪፕቶችን አይፈልግም፣ እነዚህም ጥቅሎች በሚጫኑበት ጊዜ በራስ-ሰር የሚሰሩ ስክሪፕቶች ናቸው። የመጫኛ ስክሪፕቱ ጥገኞቹን ይሰካል፤ ከዚያ በኋላ Piን ያዘምኑ በ pi update። ለ npm ጭነት፣ በጥቅል አስተዳዳሪዎ የቀረበውን የማዘመኛ ዘዴ ይጠቀሙ። Nix ተጠቃሚዎች ከ Pi ፍሌክ (flake) መጫን አለባቸው። ፍሌክ ሶፍትዌርን እና ጥገኞቹን የሚገልጽ የ Nix ውቅር ነው፣ እና pi update የ Nix ጭነትን ማዘመን አይችልም።

ከተጫነ በኋላ፣ መጀመሪያ ተርሚናልዎ Piን ማግኘት እንደሚችል ያረጋግጡ:

pi --version

በዊንዶውስ ላይ፣ ሞዴሎች የ Bash ትዕዛዞችን እንዲፈጽሙ ከፈለጉ፣ Git for Windows መጫን ለአብዛኛዎቹ የአካባቢ ተጠቃሚዎች ይመከራል። Bash Pi አንዳንድ ትዕዛዞችን ለማሄድ የሚጠቀምበት የትዕዛዝ አካባቢ ነው። Pi ይፈትሻል shellPath ቅንብር በ ~/.pi/agent/settings.json፣ Git Bash በ Program Files ስር፣ እና ከዚያ bash.exe በ PATH ላይ፣ በዚያ ቅደም ተከተል shellPath የ Bash ቦታን ይገልጻል፣ PATH ደግሞ ስርዓቱ ትዕዛዞችን የሚፈልግባቸው ማውጫዎች ዝርዝር ነው።

Piን ከጀመሩ በኋላ፣ ማስገባት ይችላሉ !printf 'Bash is working\n' እሱን ለመፈተሽ። ፋይሎችዎ እና መሳሪያዎችዎ ቀድሞውኑ በ WSL ውስጥ ካሉ፣ ፈጣን ጅምርን በመከተል Piን በዚያ የሊኑክስ አካባቢ ይጫኑ።

በመቀጠል፣ Pi እንዲመረምር ወይም እንዲሰራበት የሚፈልጉትን አቃፊ ያስገቡ፣ ከዚያ ያስጀምሩት:

cd /path/to/folder
pi

ይህ አቃፊ የ Pi የአሁኑ የስራ ወሰን ይሆናል። Pi ፋይሎችን እና ውቅሮችን ለማግኘት እና ክፍለ-ጊዜዎችን ለመቧደን ይጠቀምበታል።

ከ OmniProxy የግንኙነት እሴቶችን ያግኙ

መጀመሪያ፣ እነዚህን ሶስት እሴቶች ከ OmniProxy ያግኙ:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy the full ID from the current OmniProxy model list

baseUrl Pi ጥያቄዎችን የሚልክበት የ API የመጨረሻ ነጥብ (endpoint) ነው፣ እና ማካተት አለበት /v1. apiKey APIን ለመድረስ የሚያገለግል ቁልፍ ነው። Model ID ሊጠራ የሚገባው ሞዴል ስም ነው እና ከአሁኑ የ OmniProxy ሞዴል ዝርዝር ሙሉ በሙሉ መቅዳት አለበት።

ያዘጋጁ api ወደ openai-completions፣ በተኳሃኝ የ API ምሳሌ ላይ እንደሚታየው። ይህ መስክ ጥያቄዎችን በሚልክበት ጊዜ የትኛውን የ API ቅርጸት እንደሚጠቀም ለ Pi ይነግረዋል።

ሙሉውን የሞዴል መታወቂያ ይቅዱ፣ በስሙ ውስጥ ያሉትን ማንኛውንም ሰያፍ መስመሮች ጨምሮ። በ2026-10-09፣ በአቅራቢው ሰነድ ውስጥ ያሉት ሁለቱ የማጣቀሻ መታወቂያዎች ነበሩ gemini-3.8-flash እና grok-4.7። በዝርዝሩ ውስጥ የሌለ ስም አይቅዱ።

የመሳሪያ ውቅር ያስገቡ

የ Pi የተጠቃሚ-ደረጃ ብጁ ሞዴል ውቅር የተከማቸበት በ models.json። ይህ ፋይል በወኪል ማውጫ ውስጥ ይገኛል፣ ይህም በነባሪነት ~/.pi/agent፣ ስለዚህ ሙሉ መንገዱ ነው ~/.pi/agent/models.json። ከሆነ PI_CODING_AGENT_DIR የአካባቢ ተለዋዋጭ ተዘጋጅቷል፣ Pi በዚያ ተለዋዋጭ የተገለጸውን ማውጫ ይጠቀማል። የአካባቢ ተለዋዋጭ በስርዓቱ ለፕሮግራሞች እንዲያነቡ የሚቀርብ የውቅር እሴት ነው።

ውቅሩን በተኳሃኝ የ API ምሳሌ ላይ እንደሚታየው ያስገቡ:

{
  "providers": {
    "omniproxy": {
      "baseUrl": "https://your-omniproxy-origin.example/v1",
      "api": "openai-completions",
      "apiKey": "<YOUR_OMNIPROXY_API_KEY>",
      "models": [
        { "id": "gemini-3.8-flash", "input": ["text"] },
        { "id": "grok-4.7", "input": ["text"] }
      ]
    }
  }
}

providers የተገናኙ አገልግሎቶችን ይዘረዝራል፣ ሳለ models ሊመረጡ የሚችሉ ሞዴሎችን ይዘረዝራል። የእያንዳንዱ ሞዴል id በአሁኑ የ OmniProxy ሞዴል ዝርዝር ውስጥ ካለው ሙሉ የሞዴል መታወቂያ ጋር መዛመድ አለበት። input ሞዴሉ ለጽሑፍ ግቤት እዚህ መዋቀሩን ያሳያል።

apiKey እንደ ቃል በቃል እሴት ሊገባ ይችላል፣ ወይም እንደ $NAME ወይም ${NAME} ስለዚህ Pi ከአካባቢ ተለዋዋጭ ያነበዋል። በ የሚጀምር እሴት ! እንደ ትዕዛዝ ተደርጎ ይወሰዳል እና ለእያንዳንዱ ጥያቄ ይፈጸማል። እውነተኛ ቁልፍ ወደ ማከማቻ (repository) አይላኩ። ጌትዌይ ቁልፎችን የማያረጋግጥ ከሆነ፣ በአካባቢዎ ማሽን ላይ ብቻ ጥቅም ላይ የሚውል ቦታ ያዥ ሕብረቁምፊ ማስገባት ይችላሉ። በ2026-10-09፣ Pi ፋይሉን በዚህ ውቅር በተሳካ ሁኔታ አንብቧል።

መክፈት /model ይህንን ፋይል እንደገና ይጭናል። /model በ Pi ውስጥ ሞዴሎችን ለመመልከት እና ለመምረጥ በይነገጽ ነው። ብጁ ሞዴሎች በ ውስጥ አይታዩም /model Pi ምስክርነታቸውን እስኪፈታ ድረስ። ሞዴል ከመረጡ በኋላ ይጫኑ Ctrl+S ለአዳዲስ ክፍለ-ጊዜዎች እንደ ነባሪ ሞዴል ለማስቀመጥ።

ፋይል

models.json

• ነባሪ ማውጫ: ~/.pi/agent
• በ አቅራቢዎች ስር ግቤት ያክሉ
• apiን ወደ completions ያዘጋጁ

አድራሻ

baseUrl

• /v1 ያካትቱ
• apiKey ተለዋዋጭ ሊያመለክት ይችላል
• የሞዴል መታወቂያው ትክክለኛ መሆን አለበት

ይምረጡ

/model

• መክፈት ፋይሉን እንደገና ይጭናል
• አሁን የጨመሩትን ሞዴል ይምረጡ
• Ctrl+S እንደ ነባሪ ያስቀምጠዋል

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

ውቅሩን ካጠናቀቁ በኋላ፣ ፋይሎችን በያዘ ማውጫ ውስጥ በይነተገናኝ ያልሆነ ፍተሻ ማድረግ ይችላሉ። በይነተገናኝ ያልሆነ ሁነታ ማለት Pi ይህንን አንድ ስራ ያጠናቅቃል እና ከዚያ ቀጣይ ውይይት ከመጀመር ይልቅ ይወጣል። ከ በኋላ ያለውን እሴት ይተኩ --model ከአሁኑ የ OmniProxy ዝርዝር ሙሉ መታወቂያ ጋር:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Read the first line of the file you specify. Do not modify the file."

እዚህ፣ --tools read የንባብ መሳሪያውን ብቻ ያነቃቃል፣ እና ስራው Pi ፋይሉን እንዳይቀይር በግልጽ ያዛል። በ2026-10-09፣ Pi 1.1.0 የፋይሉን ይዘቶች በተሳካ ሁኔታ አንብቧል። የመጀመሪያው ምላሽ ሁለት ደቂቃ ያህል ወስዷል።

እንዲሁም በይነተገናኝ ሁነታን መጠቀም ይችላሉ፡ ማውጫውን ያስገቡ፣ ያሂዱ pi፣ ከዚያ ሞዴል ይምረጡ በ /model። በፈጣን ጅምር ውስጥ አንድ ምሳሌ ስራ Pi ማከማቻው እንዴት እንደተደራጀ እና ፍተሻዎቹን እንዴት እንደሚያሄድ እንዲያብራራ ይጠይቃል። ፋይሎችን እንደሚያነብ እና ማብራሪያ እንደሚሰጥ ይመልከቱ፣ ከዚያ በ OmniProxy ጥያቄ መዝገቦች ውስጥ ምንጩን እና የሞዴል መታወቂያውን ያረጋግጡ።

አስጀምር

pi ይጀምራል

• መጀመሪያ ወደ አቃፊው cd ያድርጉ
• pi --version ውጤት ያመጣል
• የሞዴል ስሙ በበይነገጹ ግርጌ ይታያል

ስራ

ማውጫውን አንብቧል

• ማከማቻው እንዴት እንደተደራጀ ይጠይቁ
• የሚዘረዝራቸውን ፋይሎች ይገምግሙ
• በስኬታማ ውቅር ቁጠባ ላይ ብቻ አይመኑ

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

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

• ምንጩ Pi ነው
• የሞዴል መታወቂያ ይዛመዳል
• ቁልፉን በአካባቢው ማሽን ላይ ያቆዩ

የተለመዱ ስህተቶች

• pi ማግኘት አልተቻለም፡ ተርሚናሉን እንደገና ይክፈቱ እና ይሞክሩ pi --version እንደገና። ለ npm ጭነት፣ ግሎባል ቢን ማውጫው በ PATH ላይ መሆኑን ያረጋግጡ።
• ብጁ ሞዴሎች በ ውስጥ አይታዩም /model: ያረጋግጡ models.json በ ውስጥ ነው ~/.pi/agent/፣ ያረጋግጡ apiKey ሊፈታ ይችላል፣ እና ከዚያ እንደገና ይክፈቱ /model።
• ዊንዶውስ Bash ማግኘት አልተቻለም ብሎ ይዘግባል፡ Git for Windows ይጫኑ፣ ወይም ያዘጋጁ shellPath በ ~/.pi/agent/settings.json። በ JSON ውስጥ ያሉ ሰያፍ መስመሮች ሁለት ጊዜ መጻፍ አለባቸው።
• ጥያቄው ውድቅ ተደርጓል፡ ያረጋግጡ api ነው openai-completions እና ያ baseUrl በ ያበቃል /v1። አገልግሎቱ እራሱን እንደ ተኳሃኝ ስለሚገልጽ ብቻ ተጨማሪ የተኳኋኝነት አማራጮችን አያነቁ።
• የሞዴል መታወቂያው ልክ ያልሆነ ነው፡ ከአሁኑ የ OmniProxy ዝርዝር እንደገና ይቅዱት።

ኦፊሴላዊ ማጣቀሻዎች

ለመጫኛ ትዕዛዞች፣ Pi website ይመልከቱ እና Quickstart። ለሞዴል ፋይል፣ Choose a Model ይመልከቱ እና Configuration። ለዊንዶውስ ትዕዛዝ አካባቢ፣ Run Pi on Windows ይመልከቱ። በምሳሌዎቹ ውስጥ ጥቅም ላይ የዋሉ የሞዴል መታወቂያዎች፣ Gemini model list ይመልከቱ እና xAI models page.

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

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

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