gooseని ఇన్‌స్టాల్ చేయడం మరియు కస్టమ్ ప్రొవైడర్‌ను కాన్ఫిగర్ చేయడం

goose అనేది మీ కంప్యూటర్‌లో రన్ అయ్యే ఒక సాధారణ-ప్రయోజన AI అసిస్టెంట్. కోడింగ్‌తో పాటు, ఇది పరిశోధన, రచన, ఆటోమేషన్ మరియు డేటా ఆర్గనైజేషన్‌ను నిర్వహించగలదు. మీరు దీన్ని డెస్క్‌టాప్ యాప్, టెర్మినల్ లేదా API ద్వారా ఉపయోగించవచ్చు, మరియు డెస్క్‌టాప్ మరియు టెర్మినల్ వెర్షన్‌లు ఒకే మోడల్ కాన్ఫిగరేషన్‌ను పంచుకుంటాయి. ఇది పునరావృత కోడింగ్ పనులకు అనుకూలంగా ఉంటుంది మరియు GitHub, డేటాబేస్‌లు మరియు ఫైల్‌లకు కూడా కనెక్ట్ చేయగలదు.

మీరు ప్రారంభించే ముందు

goose రెండు ఇన్‌స్టాలేషన్ ఎంపికలను అందిస్తుంది: డెస్క్‌టాప్ మరియు CLI. డెస్క్‌టాప్ అనేది విండోతో కూడిన గ్రాఫికల్ వెర్షన్, అయితే CLIని టెర్మినల్‌లో కమాండ్‌లను నమోదు చేయడం ద్వారా ఉపయోగిస్తారు. రెండూ ప్రొవైడర్ మరియు మోడల్‌తో సహా ఒకే కోర్ కాన్ఫిగరేషన్‌ను పంచుకుంటాయి. ప్రొవైడర్ అనేది ఏ మోడల్ సర్వీస్‌ను ఉపయోగించాలో gooseకి చెప్పే కనెక్షన్ కాన్ఫిగరేషన్.

విండో కావాలా

goose డెస్క్‌టాప్

• macOSలో జిప్‌ను డౌన్‌లోడ్ చేయండి
• లేదా brew caskని ఉపయోగించండి
• Linuxలో ఇన్‌స్టాలర్ ప్యాకేజీని ఉపయోగించండి

టెర్మినల్ మాత్రమే

goose CLI

• download_cli.sh
• లేదా Homebrew CLI
• తర్వాత goose sessionని రన్ చేయండి

Windows

ముందుగా ఒక ఎన్విరాన్‌మెంట్‌ను ఎంచుకోండి

• Git Bash లేదా MSYS2
• మీరు PowerShellని కూడా ఉపయోగించవచ్చు
• కమాండ్ కనుగొనబడకపోతే, దాన్ని PATHకి జోడించండి

ప్రారంభించే ముందు, ప్రస్తుత మోడల్ జాబితా నుండి మోడల్ IDని సిద్ధంగా ఉంచుకోండి. మోడల్ ID అనేది ఒక నిర్దిష్ట మోడల్‌ను గుర్తించడానికి మోడల్ సర్వీస్ ఉపయోగించే పేరు, మరియు మీరు దాన్ని ఉపయోగిస్తున్నప్పుడు పూర్తి IDని కాపీ చేయాలి.

మొదటిసారి ఇన్‌స్టాల్ చేసి ప్రారంభించడం

మీకు గ్రాఫికల్ విండో కావాలంటే

macOS కోసం రెండు డాక్యుమెంట్ చేయబడిన ఇన్‌స్టాలేషన్ పద్ధతులు ఉన్నాయి:

• ఇన్‌స్టాలేషన్ పేజీ నుండి దీన్ని డౌన్‌లోడ్ చేయండి. పేజీ macOS సిలికాన్ మరియు macOS ఇంటెల్ వెర్షన్‌లను అందిస్తుంది. డౌన్‌లోడ్ చేసిన తర్వాత, జిప్ ఫైల్‌ను ఎక్స్‌ట్రాక్ట్ చేసి, లోపల ఉన్న అప్లికేషన్‌ను రన్ చేయండి.
• ప్రత్యామ్నాయంగా, 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

ఇన్‌స్టాలేషన్ సమయంలో ఇంటరాక్టివ్ కాన్ఫిగరేషన్‌ను దాటవేయడానికి, bashకి ముందు CONFIGURE=falseని జోడించండి:

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, ఇది Windows కోసం Gitతో చేర్చబడింది మరియు సిఫార్సు చేయబడింది; 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ని ఉపయోగించినప్పుడు, అది మిమ్మల్ని ప్రొవైడర్‌ను కాన్ఫిగర్ చేయమని అడుగుతుంది. మీరు అంతర్నిర్మిత ప్రొవైడర్‌లను దాటవేసి, తదుపరి విభాగంలో వివరించిన విధంగా కస్టమ్ ప్రొవైడర్‌ను జోడించవచ్చు. టెర్మినల్‌లో, మీరు పని చేయాలనుకుంటున్న డైరెక్టరీకి వెళ్లి ఇలా రన్ చేయండి:

goose session

OmniProxy నుండి కనెక్షన్ విలువలను పొందడం

మీ స్వంత OmniProxy ఇన్‌స్టాన్స్ నుండి చిరునామా, కీ మరియు మోడల్ పేరును సిద్ధం చేసుకోండి. కస్టమ్ ప్రొవైడర్ ఉదాహరణ /v1/chat/completionsతో ముగిసే base_urlని ఉపయోగిస్తుంది, కాబట్టి ఈ గైడ్ అదే ఫార్మాట్‌ను అనుసరిస్తుంది:

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 నాటికి, ప్రొవైడర్ డాక్యుమెంటేషన్‌లోని రెండు రిఫరెన్స్ IDలు Grok కోసం grok-4.7 మరియు OpenAI డాక్యుమెంటేషన్ నుండి gpt-6-luna. gpt-6-luna చాట్ కంప్లీషన్స్‌కు మద్దతు ఇస్తుంది; చాట్ కంప్లీషన్స్‌లో ఫంక్షన్ కాలింగ్‌కు reasoning_effortని noneకి సెట్ చేసినప్పుడు మాత్రమే మద్దతు ఉంటుంది. జాబితాలో కనిపించని పేరును కాపీ చేయవద్దు.

టూల్ కాన్ఫిగరేషన్‌ను నమోదు చేయడం

కస్టమ్ ప్రొవైడర్ OpenAI-, Anthropic-, లేదా Ollama-అనుకూల ఫార్మాట్‌ను ఉపయోగించవచ్చు. అనుకూల ఫార్మాట్ అంటే సాధనం సాధారణ API స్పెసిఫికేషన్ ప్రకారం అభ్యర్థనలను పంపుతుందని అర్థం. OmniProxyకి కనెక్ట్ చేస్తున్నప్పుడు, OpenAI Compatibleని ఎంచుకోండి.

డెస్క్‌టాప్

1. సైడ్‌బార్‌ను తెరవడానికి ఎగువ-ఎడమ మూలలో ఉన్న బటన్‌ను క్లిక్ చేయండి.
2. Settings క్లిక్ చేయండి.
3. Models క్లిక్ చేయండి.
4. Configure providers క్లిక్ చేయండి.
5. విండో దిగువన Add Custom Provider క్లిక్ చేయండి.
6. ప్రొవైడర్ రకం కోసం, OpenAI Compatibleని ఎంచుకోండి. మీరు డిస్‌ప్లే పేరును OmniProxyగా సెట్ చేయవచ్చు. API URLలో మునుపటి విభాగం నుండి చిరునామాను నమోదు చేయండి. కీ అవసరమైతే, API కీ అవసరమయ్యే ఎంపికను ఎంచుకుని, మీ OmniProxy కీని నమోదు చేయండి. అందుబాటులో ఉన్న మోడల్స్‌లో, మోడల్ పేర్లను నమోదు చేయండి, బహుళ పేర్లను కామాలతో వేరు చేయండి.
7. Create Provider క్లిక్ చేయండి.

డెస్క్‌టాప్ వెర్షన్ ప్రస్తుతం ఈ విండోలో కస్టమ్ రిక్వెస్ట్ హెడర్‌లను నిర్వచించలేదు. మీకు రిక్వెస్ట్ హెడర్‌లు అవసరమైతే, ప్రొవైడర్‌ను సృష్టించిన తర్వాత కాన్ఫిగరేషన్ ఫైల్‌ను ఎడిట్ చేయండి.

టెర్మినల్

రన్ చేయండి:

goose configure

Custom Providersని ఎంచుకోండి, ఆపై Add A Custom Providerని ఎంచుకోండి. API రకం కోసం, OpenAI Compatibleని ఎంచుకోండి, ఆపై పేరు, API URL, కీ అవసరమా, మోడల్ పేర్లు మరియు స్ట్రీమింగ్ ప్రతిస్పందనలకు మద్దతు ఉందా అని నమోదు చేయడానికి ప్రాంప్ట్‌లను అనుసరించండి.

Windowsలో మాన్యువల్‌గా కాన్ఫిగర్ చేస్తున్నప్పుడు, కీచైన్ లోపాన్ని నివేదిస్తే, కీని కీరింగ్‌లో సేవ్ చేయవద్దని మరియు దానికి బదులుగా ఎన్విరాన్‌మెంట్ వేరియబుల్‌ను ఉపయోగించమని ఇన్‌స్టాలేషన్ సూచనలు చెబుతున్నాయి. ఆపై 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 విలువను జాబితా నుండి పూర్తి IDతో భర్తీ చేయండి. goose sessionకి start సబ్‌కమాండ్ లేదు. మీరు --provider మరియు --modelని GOOSE_PROVIDER మరియు GOOSE_MODEL ఎన్విరాన్‌మెంట్ వేరియబుల్స్ ద్వారా కూడా సెట్ చేయవచ్చు. గేట్‌వే కీలను ధృవీకరించకపోయినా, OMNIPROXY_API_KEYకి ఇప్పటికీ ఒక విలువ ఉండాలి. ఇది మీ స్థానిక కంప్యూటర్‌లో మాత్రమే ఉపయోగించే ప్లేస్‌హోల్డర్ స్ట్రింగ్ కావచ్చు. ఈ కాన్ఫిగరేషన్ 2026-10-09న పరీక్షలో ఫైల్‌ను విజయవంతంగా చదివింది.

విండో

Settings

• సైడ్‌బార్‌లో సెట్టింగ్‌లు
• మోడల్స్ పేజీ
• Add Custom Provider

టెర్మినల్

goose configure

• Custom Providersని ఎంచుకోండి
• తర్వాత యాడ్ ఎంచుకోండి
• రకంగా OpenAI Compatibleని ఎంచుకోండి

ఫైల్

custom_providers

• macOS మరియు Linuxలో, ఇది ~/.config కింద ఉంటుంది
• Windowsలో, ఇది APPDATA కింద ఉంటుంది
• అధికారిక ఉదాహరణ ప్రకారం base_urlని సెట్ చేయండి

నిజమైన పనితో ధృవీకరించడం

సాధారణ ఫైల్‌ను కలిగి ఉన్న డైరెక్టరీని తెరిచి, మునుపటి విభాగంలో చూపిన విధంగా goose sessionని రన్ చేయండి. మీరు పేర్కొన్న ఫైల్ యొక్క మొదటి లైన్‌ను చదవమని అడగండి. ఇది కాన్ఫిగరేషన్ సేవ్ చేయబడిందని మాత్రమే చెప్పకుండా ఫైల్ కంటెంట్‌ను తిరిగి ఇవ్వాలి.

ఫైల్‌లను చదవడానికి లేదా కమాండ్‌లను అమలు చేయడానికి, సెషన్‌కు డెవలపర్ ఎక్స్‌టెన్షన్ అవసరం. డెవలపర్ ఎక్స్‌టెన్షన్ అనేది goose స్థానిక ఫైల్‌లు మరియు కమాండ్‌లతో పని చేయడానికి అనుమతించే ఒక టూల్ మాడ్యూల్. ఇది సాధారణంగా డిఫాల్ట్ కాన్ఫిగరేషన్‌లో చేర్చబడుతుంది. gooseకి ఫైల్ టూల్స్ లేవని చెబితే, కమాండ్‌కు ఈ క్రింది వాటిని జోడించండి:

--with-builtin developer

--no-profileని కూడా జోడించవద్దు, ఎందుకంటే ఆ ఎంపిక డిఫాల్ట్ ఎక్స్‌టెన్షన్‌లను నిలిపివేస్తుంది.

2026-10-09న పరీక్షలో, goose 1.54.0 పేర్కొన్న ఫైల్ యొక్క మొదటి లైన్‌ను విజయవంతంగా చదివింది. మొదటి ప్రతిస్పందనకు సుమారు ఒక నిమిషం పట్టవచ్చు.

ఆపై మూలం మరియు మోడల్ పేరును నిర్ధారించడానికి OmniProxy అభ్యర్థన లాగ్‌లను తనిఖీ చేయండి.

ప్రారంభించండి

ఒక సెషన్ తెరుచుకుంటుంది

• goose session
• ప్రొవైడర్ ఇప్పుడే జోడించినది
• మోడల్ పేరు జాబితాలో ఉంది

పని

ఇది వాస్తవంగా పనిని పూర్తి చేసింది

• ఉదాహరణకు, ప్రస్తుత డైరెక్టరీని జాబితా చేయండి
• దాని ప్రతిస్పందనను సమీక్షించండి
• విజయవంతమైన సేవ్ మీద మాత్రమే ఆధారపడవద్దు

లాగ్‌లు

గేట్‌వేలో కనిపిస్తాయి

• డాక్యుమెంటేషన్ ఉదాహరణ నుండి చిరునామాను ఉపయోగించండి
• కీని రిపోజిటరీలో ఉంచవద్దు
• మోడల్ ID జాబితాతో సరిపోలుతుంది

సాధారణ లోపాలు

• goose కమాండ్ కనుగొనబడలేదు: ఇన్‌స్టాలేషన్ పేజీలో వివరించిన విధంగా ఇన్‌స్టాలేషన్ డైరెక్టరీని PATHకి జోడించండి, ఆపై టెర్మినల్‌ను మళ్లీ తెరవండి.
• M3 Macలో డెస్క్‌టాప్ వెర్షన్‌లో విండో కనిపించదు: ~/.config కోసం చదవడానికి మరియు వ్రాయడానికి అనుమతులను తనిఖీ చేయండి.
• కీచైన్ విఫలమైంది: కీని కీరింగ్‌లో సేవ్ చేయవద్దు; దానికి బదులుగా ఎన్విరాన్‌మెంట్ వేరియబుల్‌ను ఉపయోగించండి.
• మోడల్ జాబితాలో లేదు: డెస్క్‌టాప్ వెర్షన్‌లో, Use custom modelని ఎంచుకుని, మోడల్ పేరును మాన్యువల్‌గా నమోదు చేయండి. goose configure కస్టమ్ మోడల్ పేరును అంగీకరించదు. టెర్మినల్ ఉపయోగం కోసం, డెస్క్‌టాప్ వెర్షన్‌కు మారండి లేదా కాన్ఫిగరేషన్‌లో GOOSE_MODELని నేరుగా ఎడిట్ చేయండి.
• చిరునామాను చేరుకోలేము: API URL ఉదాహరణలో వలె /v1/chat/completionsతో ముగుస్తుందని మరియు OmniProxy రన్ అవుతుందని నిర్ధారించుకోండి.
• ఇది ఫైల్‌లను చదవలేమని చెబుతోంది: డెవలపర్ ఎక్స్‌టెన్షన్‌ను జోడించండి మరియు --no-profileని ఉపయోగించవద్దు.
• ఇది unsupported Responses role: systemని తిరిగి ఇస్తుంది: చిరునామా సాధారణంగా సరైనదే. మోడల్ జాబితా నుండి మరొక పూర్తి IDకి మారండి.

అధికారిక రిఫరెన్స్‌లు

ఇన్‌స్టాలేషన్ కోసం, Install goose చూడండి. కస్టమ్ ప్రొవైడర్ల కోసం, goose providers చూడండి. ఉదాహరణలలో ఉపయోగించిన మోడల్ IDల కోసం, xAI మోడల్స్ పేజీ మరియు GPT-6 Luna చూడండి.

మీ స్వంత OmniProxy కన్ఫిగరేషన్ నుండి విలువలతో ప్రతి ప్లేస్‌హోల్డర్‌ను మార్చండి. నిజమైన కీని ఎప్పుడూ ప్రచురించకండి.

సేవ్ చేసిన ఫలితం లేదా HTTP 200 మాత్రమే పూర్తి ఏజెంట్ అనుకూలతను నిరూపించదు. OmniProxy కాల్ రికార్డ్‌లో వనరు మరియు మాడల్‌ను తనిఖీ చేయండి.

అధికారిక వనరులు · goose ↗