goose ን መጫን እና ብጁ አቅራቢን ማዋቀር

goose በኮምፒውተርዎ ላይ የሚሰራ አጠቃላይ የAI ረዳት ነው። ኮድ ከመጻፍ በተጨማሪ፣ ምርምርን፣ መጻፍን፣ አውቶሜሽንን እና የውሂብ አደረጃጀትን ማስተናገድ ይችላል። በዴስክቶፕ መተግበሪያ፣ ተርሚናል ወይም API በኩል ሊጠቀሙበት ይችላሉ፣ እና የዴስክቶፕ እና የተርሚናል ስሪቶች ተመሳሳይ የሞዴል ውቅር ይጋራሉ። ለተደጋጋሚ የኮድ ስራዎች ተስማሚ ነው እና ከGitHub፣ የውሂብ ጎታዎች እና ፋይሎች ጋር መገናኘት ይችላል።

ከመጀመርዎ በፊት

goose ሁለት የመጫኛ አማራጮችን ያቀርባል: ዴስክቶፕ እና CLI። ዴስክቶፕ መስኮት ያለው ግራፊክ ስሪት ነው፣ CLI ደግሞ በተርሚናል ውስጥ ትዕዛዞችን በማስገባት ጥቅም ላይ ይውላል። ሁለቱም ተመሳሳይ ዋና ውቅር ይጋራሉ፣ አቅራቢውን (Provider) እና ሞዴሉን ጨምሮ። አቅራቢ ማለት goose የትኛውን የሞዴል አገልግሎት መጠቀም እንዳለበት የሚነግረው የግንኙነት ውቅር ነው።

መስኮት ይፈልጋሉ

goose Desktop

• በmacOS ላይ ዚፕውን ያውርዱ
• ወይም brew cask ይጠቀሙ
• በLinux ላይ የመጫኛ ጥቅሉን ይጠቀሙ

ተርሚናል ብቻ

goose CLI

• download_cli.sh
• ወይም Homebrew CLI
• ከዚያ goose session ያሂዱ

Windows

መጀመሪያ አካባቢ ይምረጡ

• Git Bash ወይም MSYS2
• PowerShell መጠቀምም ይችላሉ
• ትዕዛዙ ካልተገኘ፣ ወደ PATH ያክሉት

ከመጀመርዎ በፊት፣ ከአሁኑ የሞዴል ዝርዝር ውስጥ የሞዴል መታወቂያውን ዝግጁ ያድርጉ። የሞዴል መታወቂያ ሞዴሉ አገልግሎቱ የተወሰነ ሞዴልን ለመለየት የሚጠቀምበት ስም ነው፣ እና ሲጠቀሙበት ሙሉውን መታወቂያ መቅዳት አለብዎት።

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

ግራፊክ መስኮት ከፈለጉ

ለmacOS ሁለት የተመዘገቡ የመጫኛ ዘዴዎች አሉ:

• ከመጫኛ ገጹ ያውርዱት። ገጹ የmacOS Silicon እና macOS Intel ስሪቶችን ያቀርባል። ካወረዱ በኋላ፣ የዚፕ ፋይሉን ያውጡ እና መተግበሪያውን በውስጡ ያሂዱ።
• በአማራጭ፣ Homebrew ይጠቀሙ:

brew install --cask block-goose

ይህ ተመሳሳይ መተግበሪያን ያወርዳል እና ዝመናዎችንም ማስተናገድ ይችላል።

Apple Mac M3 እየተጠቀሙ ከሆነ እና መተግበሪያውን ከከፈቱ በኋላ ምንም መስኮት ካልታየ፣ ያረጋግጡ ~/.config ሊነበብ እና ሊጻፍ የሚችል መሆኑን። goose ምዝግብ ማስታወሻዎችን ለመጻፍ ይህንን ማውጫ ይጠቀማል።

ለLinux ዴስክቶፕ ስሪት፣ ከመጫኛ ገጹ ያውርዱት። የሚገኙት ጥቅሎች ለUbuntu/Debian የDEB፣ ለRHEL/Fedora የRPM፣ እና Flatpak ናቸው። በDebian ወይም Ubuntu ላይ፣ የDEB ፋይሉን ያውርዱ፣ የተቀመጠበትን ማውጫ ይክፈቱ፣ ያሂዱ sudo dpkg -i (filename).deb፣ እና ከዚያ goose ን ከመተግበሪያው ምናሌ ይክፈቱ። ይተኩ (filename) በትክክለኛው የፋይል ስም

ለWindows ዴስክቶፕ ስሪት፣ ከመጫኛ ገጹ ያውርዱት፣ የዚፕ ፋይሉን ያውጡ እና መተግበሪያውን በውስጡ ያሂዱ።

የተርሚናል ስሪት ብቻ ከፈለጉ

በmacOS እና Linux ላይ፣ ያሂዱ:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

በመጫን ጊዜ በይነተገናኝ ውቅርን ለመዝለል፣ ያክሉ CONFIGURE=false ከዚህ በፊት bash:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

በmacOS ላይ፣ ማሄድም ይችላሉ:

brew install block-goose-cli

የተጫነ CLI ን ለማዘመን፣ ያሂዱ:

goose update

በWindows ላይ፣ ከሚከተሉት ሶስት አካባቢዎች አንዱ ያስፈልጋል: Git Bash፣ ይህም ከGit for Windows ጋር የተካተተ እና እንደ ተመከረ ምልክት የተደረገበት; MSYS2; ወይም በWindows 10/11 የተካተተ PowerShell። በGit Bash እና MSYS2 ውስጥ፣ ተመሳሳይ ይጠቀሙ download_cli.sh ከላይ የታየው ትዕዛዝ። በPowerShell ውስጥ፣ ስክሪፕቱን መጀመሪያ ያውርዱ እና ከዚያ ያሂዱ:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

goose በPATH ውስጥ የለም ከተባሉ፣ የመጫኛ ገጹን ይከተሉ እና ያክሉ ~/.local/bin ወይም %USERPROFILE%\.local\bin ወደ የአሁኑ ሼል ውቅር፣ ከዚያ ተርሚናሉን እንደገና ይክፈቱ። PATH ተርሚናሉ ፕሮግራሞችን የሚፈልግበት የማውጫዎች ስብስብ ነው። የመጫኛ ማውጫው ካልተካተተ፣ የተጫነ ፕሮግራም ስሙን በቀጥታ በማስገባት ማሄድ ላይችሉ ይችላሉ።

እ.ኤ.አ. በ2026-10-09፣ የCLI ስሪት 1.54.0 ነበር። በነባሪነት፣ የመጫኛ ስክሪፕቱ ፕሮግራሙን ያስቀምጣል ~/.local/bin። ይህንን ማውጫ በ GOOSE_BIN_DIR የአካባቢ ተለዋዋጭ መቀየር ይችላሉ። ከቀየሩት፣ ስክሪፕቱ የሼል ውቅሩን በራስ-ሰር አያዘምንም፣ እና ተርሚናሉ ማውጫው በPATH ውስጥ የለም ብሎ ሪፖርት ያደርጋል። ያንን ማውጫ ወደ PATH ያክሉት ወይም goose ን ሙሉ መንገዱን በመጠቀም ያሂዱ።

goose ን ለመጀመሪያ ጊዜ ሲጠቀሙ፣ አቅራቢ (Provider) እንዲያዋቅሩ ይጠይቅዎታል። አብሮ የተሰሩ አቅራቢዎችን መዝለል እና ብጁ አቅራቢን በሚቀጥለው ክፍል እንደተገለጸው ማከል ይችላሉ። በተርሚናል ውስጥ፣ መስራት ወደሚፈልጉበት ማውጫ ይሂዱ እና ያሂዱ:

goose session

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

አድራሻውን፣ ቁልፉን እና የሞዴል ስሙን ከራስዎ የOmniProxy ምሳሌ ያዘጋጁ። ብጁ የአቅራቢ ምሳሌ ይጠቀማል base_url በመጨረሻ /v1/chat/completions፣ ስለዚህ ይህ መመሪያ ተመሳሳይ ቅርጸት ይከተላል:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Copy from the current OmniProxy model list; separate multiple models with commas

ሙሉውን የሞዴል ስም ከአሁኑ የOmniProxy ዝርዝር ይቅዱ፣ ማናቸውንም ሰያፍ መስመሮች ጨምሮ። እ.ኤ.አ. በ2026-10-09፣ በአቅራቢው ሰነድ ውስጥ ሁለት የማጣቀሻ መታወቂያዎች ነበሩ grok-4.7 ለGrok እና gpt-6-luna ከOpenAI ሰነድ። gpt-6-luna Chat Completions ን ይደግፋል; በChat Completions ውስጥ የተግባር ጥሪ የሚደገፈው ብቻ ነው reasoning_effort ሲዘጋጅ none። በዝርዝሩ ውስጥ የማይታይ ስም አይቅዱ።

የመሳሪያውን ማዋቀር ያስገቡ

ብጁ አቅራቢ OpenAI-፣ Anthropic- ወይም Ollama-ተኳሃኝ ቅርጸት መጠቀም ይችላል። ተኳሃኝ ቅርጸት ማለት መሳሪያው ጥያቄዎችን እንደ የጋራ የAPI ዝርዝር መግለጫ ይልካል ማለት ነው። ከOmniProxy ጋር ሲገናኙ፣ OpenAI Compatible ን ይምረጡ።

ዴስክቶፕ

1. የጎን አሞሌውን ለመክፈት በላይኛው ግራ ጥግ ላይ ያለውን ቁልፍ ጠቅ ያድርጉ።
2. Settings ን ጠቅ ያድርጉ።
3. Models ን ጠቅ ያድርጉ።
4. Configure providers ን ጠቅ ያድርጉ።
5. በመስኮቱ ግርጌ Add Custom Provider ን ጠቅ ያድርጉ።
6. ለአቅራቢ አይነት (Provider Type)፣ OpenAI Compatible ን ይምረጡ። የማሳያ ስም (Display Name) ወደ OmniProxy ማዘጋጀት ይችላሉ። ከቀዳሚው ክፍል ያለውን አድራሻ በAPI URL ውስጥ ያስገቡ። ቁልፍ የሚያስፈልግ ከሆነ፣ API Key የሚፈልገውን አማራጭ ይምረጡ እና የOmniProxy ቁልፍዎን ያስገቡ። በሚገኙ ሞዴሎች (Available Models) ውስጥ፣ የሞዴል ስሞችን ያስገቡ፣ ብዙ ስሞችን በኮማ ይለዩ።
7. Create Provider ን ጠቅ ያድርጉ።

የዴስክቶፕ ስሪቱ በአሁኑ ጊዜ በዚህ መስኮት ውስጥ ብጁ የጥያቄ ራስጌዎችን (request headers) መግለጽ አይችልም። የጥያቄ ራስጌዎች ከፈለጉ፣ አቅራቢውን ከፈጠሩ በኋላ የማዋቀሪያ ፋይሉን ያርትዑ።

ተርሚናል

ያሂዱ:

goose configure

ይምረጡ Custom Providers፣ ከዚያ ይምረጡ Add A Custom Provider። ለAPI አይነት፣ OpenAI Compatible ን ይምረጡ፣ ከዚያ ስሙን፣ API URL ን፣ ቁልፍ የሚያስፈልግ መሆኑን፣ የሞዴል ስሞችን እና የዥረት ምላሾች (streaming responses) የሚደገፉ መሆናቸውን ለማስገባት ጥያቄዎቹን ይከተሉ።

በWindows ላይ በእጅ ሲያዋቅሩ፣ ቁልፍ ሰንሰለቱ (keychain) ስህተት ከዘገበ፣ የመጫኛ መመሪያዎቹ ቁልፉን በቁልፍ ሰንሰለቱ ውስጥ ማስቀመጥን ውድቅ እንዲያደርጉ እና ይልቁንስ የአካባቢ ተለዋዋጭ እንዲጠቀሙ ይናገራሉ። ከዚያ ያሂዱ goose configure እንደገና። ቁልፍ ሰንሰለት ሚስጥሮችን ለማከማቸት በስርዓተ ክወናው ጥቅም ላይ የሚውል ትንሽ ደህንነቱ የተጠበቀ የማከማቻ ስርዓት ነው።

የማዋቀሪያ ፋይል

የተመዘገቡት ማውጫዎች ናቸው:

• macOS እና Linux: ~/.config/goose/custom_providers/
• Windows: %APPDATA%\Block\goose\config\custom_providers\

ፋይሉን በቀረበው ምሳሌ ላይ መመስረት ይችላሉ። ስሙን፣ አድራሻውን እና ሞዴሎቹን በራስዎ እሴቶች ይተኩ። ቁልፉን በተጠቀሰው የአካባቢ ተለዋዋጭ ውስጥ ያከማቹ api_key_env; እውነተኛውን ቁልፍ በፋይሉ ውስጥ አይጻፉ:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

ለቁጥር እሴት ያቆዩ context_limit፣ በምሳሌው ላይ እንደሚታየው። ትክክለኛው የአውድ ገደብ በሞዴሉ እና በOmniProxy ላይ የተመሰረተ ነው; የምሳሌውን ቁጥር እንደ ሞዴሉ ኦፊሴላዊ ገደብ አይውሰዱ። ከመጠቀምዎ በፊት፣ ያሂዱ:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

የስራ ማውጫውን ከገቡ በኋላ፣ ያሂዱ:

goose session --provider omniproxy --model grok-4.7

የእሴቱን ይተኩ --model ከዝርዝሩ ውስጥ ሙሉ መታወቂያ ጋር።

አለው goose session የለውም start ንዑስ ትዕዛዝ። ማዘጋጀትም ይችላሉ --provider እና --model በኩል GOOSE_PROVIDER እና GOOSE_MODEL የአካባቢ ተለዋዋጮች። ጌትዌይ ቁልፎችን ባያረጋግጥም፣ OMNIPROXY_API_KEY አሁንም እሴት ሊኖረው ይገባል። በአካባቢዎ ኮምፒውተር ላይ ብቻ ጥቅም ላይ የሚውል ቦታ ያዥ ሕብረቁምፊ ሊሆን ይችላል። ይህ ውቅር እ.ኤ.አ. በ2026-10-09 በሙከራ ላይ ፋይል በተሳካ ሁኔታ አንብቧል።

መስኮት

Settings

• Settings በጎን አሞሌው ውስጥ
• Models ገጽ
• Add Custom Provider

ተርሚናል

goose configure

• Custom Providers ይምረጡ
• ከዚያ add ይምረጡ
• OpenAI Compatible ን እንደ አይነት ይምረጡ

ፋይል

custom_providers

• በmacOS እና Linux ላይ፣ በ~/.config ስር ነው
• በWindows ላይ፣ በAPPDATA ስር ነው
• base_url ን በኦፊሴላዊው ምሳሌ መሰረት ያዘጋጁ

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

መደበኛ ፋይል የያዘ ማውጫ ይክፈቱ እና ያሂዱ goose session በቀደመው ክፍል እንደታየው። የገለጹትን ፋይል የመጀመሪያ መስመር እንዲያነብ ይጠይቁት። ውቅሩ እንደተቀመጠ ከመናገር ይልቅ የፋይሉን ይዘቶች መመለስ አለበት።

ፋይሎችን ለማንበብ ወይም ትዕዛዞችን ለማስፈጸም፣ ክፍለ-ጊዜው (session) የDeveloper ቅጥያ ያስፈልገዋል። የDeveloper ቅጥያ goose ከአካባቢያዊ ፋይሎች እና ትዕዛዞች ጋር እንዲሰራ የሚያስችል የመሳሪያ ሞጁል ነው። በአጠቃላይ በነባሪ ውቅር ውስጥ ተካትቷል። goose ምንም የፋይል መሳሪያዎች የሉትም ካለ፣ የሚከተለውን ወደ ትዕዛዙ ያክሉ:

--with-builtin developer

አያክሉ --no-profile፣ ምክንያቱም ያ አማራጭ ነባሪ ቅጥያዎችን ያሰናክላል።

እ.ኤ.አ. በ2026-10-09 በሙከራ ላይ፣ goose 1.54.0 የተገለጸውን ፋይል የመጀመሪያ መስመር በተሳካ ሁኔታ አንብቧል። የመጀመሪያው ምላሽ ወደ አንድ ደቂቃ ሊወስድ ይችላል።

ከዚያ ምንጩን እና የሞዴል ስሙን ለማረጋገጥ የOmniProxy ጥያቄ ምዝግብ ማስታወሻዎችን ያረጋግጡ።

ማስጀመሪያ

ክፍለ-ጊዜ ይከፈታል

• goose session
• አቅራቢው አሁን የታከለው ነው
• የሞዴል ስሙ በዝርዝሩ ውስጥ ነው

ስራ

ስራውን በእርግጥ አጠናቋል

• ለምሳሌ፣ የአሁኑን ማውጫ ይዘርዝሩ
• ምላሹን ይገምግሙ
• በተሳካ ቁጠባ ላይ ብቻ አይመኑ

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

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

• ከመመሪያው ምሳሌ አድራሻውን ይጠቀሙ
• ቁልፉን በማጠራቀሚያው ውስጥ አያስቀምጡ
• የሞዴል መታወቂያው ከዝርዝሩ ጋር ይዛመዳል

የተለመዱ ስህተቶች

• goose ትዕዛዙ ሊገኝ አልቻለም: የመጫኛ ማውጫውን ወደ PATH ያክሉት በመጫኛ ገጹ ላይ እንደተገለጸው፣ ከዚያ ተርሚናሉን እንደገና ይክፈቱ።
• በM3 Mac ላይ በዴስክቶፕ ስሪት ውስጥ ምንም መስኮት አይታይም: የንባብ እና የመጻፍ ፈቃዶችን ያረጋግጡ ~/.config.
• ቁልፍ ሰንሰለቱ አልተሳካም: ቁልፉን በቁልፍ ሰንሰለቱ ውስጥ አያስቀምጡ; ይልቁንስ የአካባቢ ተለዋዋጭ ይጠቀሙ።
• ሞዴሉ በዝርዝሩ ውስጥ የለም: በዴስክቶፕ ስሪት ውስጥ፣ Use custom model ን ይምረጡ እና የሞዴል ስሙን በእጅ ያስገቡ። goose configure ብጁ የሞዴል ስም መቀበል አይችልም። ለተርሚናል አጠቃቀም፣ ወደ ዴስክቶፕ ስሪት ይቀይሩ ወይም ያርትዑ GOOSE_MODEL በቀጥታ በማዋቀሪያው ውስጥ።
• አድራሻው ሊደረስበት አልቻለም: የAPI URL በመጨረሻው ላይ መሆኑን ያረጋግጡ /v1/chat/completions፣ በምሳሌው ላይ እንዳለ፣ እና OmniProxy እየሰራ መሆኑን።
• ፋይሎችን ማንበብ አልችልም ይላል: የDeveloper ቅጥያውን ያክሉ እና አይጠቀሙ --no-profile.
• ይመልሳል unsupported Responses role: system: አድራሻው ብዙውን ጊዜ ትክክል ነው። ከሞዴል ዝርዝሩ ወደ ሌላ ሙሉ መታወቂያ ይቀይሩ።

ኦፊሴላዊ ማጣቀሻዎች

ለመጫን፣ ይመልከቱ Install goose። ለብጁ አቅራቢዎች፣ ይመልከቱ goose providers። በምሳሌዎቹ ውስጥ ጥቅም ላይ የዋሉ የሞዴል መታወቂያዎች፣ ይመልከቱ xAI models page እና GPT-6 Luna.

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

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

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