Εγκατάσταση του goose και διαμόρφωση προσαρμοσμένου παρόχου

Το goose είναι ένας βοηθός AI γενικής χρήσης που εκτελείται στον υπολογιστή σας. Εκτός από τον προγραμματισμό, μπορεί να χειριστεί έρευνα, συγγραφή, αυτοματοποίηση και οργάνωση δεδομένων. Μπορείτε να το χρησιμοποιήσετε μέσω της εφαρμογής επιφάνειας εργασίας, του τερματικού ή του API, και οι εκδόσεις επιφάνειας εργασίας και τερματικού μοιράζονται την ίδια διαμόρφωση μοντέλου. Είναι κατάλληλο για επαναλαμβανόμενες εργασίες προγραμματισμού και μπορεί επίσης να συνδεθεί με το GitHub, βάσεις δεδομένων και αρχεία.

Πριν ξεκινήσετε

Το goose προσφέρει δύο επιλογές εγκατάστασης: Desktop και CLI. Το Desktop είναι η γραφική έκδοση με παράθυρο, ενώ το CLI χρησιμοποιείται εισάγοντας εντολές σε ένα τερματικό. Και τα δύο μοιράζονται την ίδια βασική διαμόρφωση, συμπεριλαμβανομένου του Παρόχου (Provider) και του μοντέλου. Ένας Πάροχος είναι η διαμόρφωση σύνδεσης που λέει στο goose ποια υπηρεσία μοντέλου να χρησιμοποιήσει.

Θέλετε ένα παράθυρο

goose Desktop

Κατεβάστε το zip σε macOS
Ή χρησιμοποιήστε το brew cask
Χρησιμοποιήστε το πακέτο εγκατάστασης σε Linux

Μόνο τερματικό

goose CLI

download_cli.sh
Ή το Homebrew CLI
Στη συνέχεια, εκτελέστε το goose session

Windows

Επιλέξτε πρώτα ένα περιβάλλον

Git Bash ή MSYS2
Μπορείτε επίσης να χρησιμοποιήσετε το PowerShell
Εάν η εντολή δεν βρεθεί, προσθέστε την στο PATH

Σε macOS, μπορείτε να το εγκαταστήσετε κατεβάζοντας την εφαρμογή ή χρησιμοποιώντας το Homebrew. Σε Linux, χρησιμοποιήστε το πακέτο της διανομής σας για την έκδοση επιφάνειας εργασίας. Στα Windows, ελέγξτε πρώτα τα υποστηριζόμενα περιβάλλοντα τερματικού.

Πριν ξεκινήσετε, έχετε έτοιμο το αναγνωριστικό μοντέλου από την τρέχουσα λίστα μοντέλων. Ένα αναγνωριστικό μοντέλου είναι το όνομα που χρησιμοποιεί η υπηρεσία μοντέλου για να αναγνωρίσει ένα συγκεκριμένο μοντέλο και πρέπει να αντιγράψετε το πλήρες αναγνωριστικό όταν το χρησιμοποιείτε.

Εγκατάσταση και πρώτη εκκίνηση

Εάν θέλετε ένα γραφικό παράθυρο

Υπάρχουν δύο τεκμηριωμένες μέθοδοι εγκατάστασης για macOS:

Κατεβάστε το από τη σελίδα εγκατάστασης. Η σελίδα παρέχει εκδόσεις για macOS Silicon και macOS Intel. Μετά τη λήψη, εξαγάγετε το αρχείο zip και εκτελέστε την εφαρμογή μέσα.
Εναλλακτικά, χρησιμοποιήστε το Homebrew:

brew install --cask block-goose

Αυτό κατεβάζει την ίδια εφαρμογή και μπορεί επίσης να διαχειριστεί ενημερώσεις.

Εάν χρησιμοποιείτε Apple Mac M3 και δεν εμφανίζεται παράθυρο μετά το άνοιγμα της εφαρμογής, ελέγξτε αν το ~/.config είναι αναγνώσιμο και εγγράψιμο. Το goose χρησιμοποιεί αυτόν τον κατάλογο για να γράφει αρχεία καταγραφής.

Για την έκδοση επιφάνειας εργασίας Linux, κατεβάστε την από τη σελίδα εγκατάστασης. Τα διαθέσιμα πακέτα είναι DEB για Ubuntu/Debian, RPM για RHEL/Fedora και Flatpak. Σε Debian ή Ubuntu, κατεβάστε το αρχείο DEB, ανοίξτε τον κατάλογο όπου αποθηκεύτηκε, εκτελέστε sudo dpkg -i (filename).debκαι, στη συνέχεια, ανοίξτε το goose από το μενού εφαρμογών. Αντικαταστήστε το (filename) με το πραγματικό όνομα αρχείου.

Για την έκδοση επιφάνειας εργασίας Windows, κατεβάστε την από τη σελίδα εγκατάστασης, εξαγάγετε το αρχείο zip και εκτελέστε την εφαρμογή μέσα.

Εάν θέλετε μόνο την έκδοση τερματικού

Σε 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· ή PowerShell που περιλαμβάνεται στα Windows 10/11. Στο 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 στην τρέχουσα διαμόρφωση του κελύφους (shell), στη συνέχεια ανοίξτε ξανά το τερματικό. Το PATH είναι ένα σύνολο καταλόγων που αναζητά το τερματικό για προγράμματα. Εάν ο κατάλογος εγκατάστασης δεν περιλαμβάνεται, ενδέχεται να μην μπορείτε να εκτελέσετε ένα εγκατεστημένο πρόγραμμα εισάγοντας απευθείας το όνομά του.

Στις 2026-10-09, η έκδοση CLI ήταν 1.54.0. Από προεπιλογή, το σενάριο εγκατάστασης τοποθετεί το πρόγραμμα στο ~/.local/bin. Μπορείτε να αλλάξετε αυτόν τον κατάλογο με τη μεταβλητή περιβάλλοντος GOOSE_BIN_DIR . Εάν την αλλάξετε, το σενάριο δεν θα ενημερώσει αυτόματα τη διαμόρφωση του κελύφους και το τερματικό θα αναφέρει ότι ο κατάλογος δεν βρίσκεται στο PATH. Προσθέστε αυτόν τον κατάλογο στο PATH ή εκτελέστε το goose χρησιμοποιώντας την πλήρη διαδρομή του.

Την πρώτη φορά που θα χρησιμοποιήσετε το goose, θα σας ζητήσει να διαμορφώσετε έναν Πάροχο. Μπορείτε να παρακάμψετε τους ενσωματωμένους παρόχους και να προσθέσετε έναν προσαρμοσμένο Πάροχο όπως περιγράφεται στην επόμενη ενότητα. Στο τερματικό, μεταβείτε στον κατάλογο όπου θέλετε να εργαστείτε και εκτελέστε:

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· η κλήση συναρτήσεων (function calling) στο Chat Completions υποστηρίζεται μόνο όταν reasoning_effort έχει οριστεί σε none. Μην αντιγράψετε ένα όνομα που δεν εμφανίζεται στη λίστα.

Εισαγωγή της διαμόρφωσης εργαλείου

Ένας προσαρμοσμένος Πάροχος μπορεί να χρησιμοποιήσει μορφή συμβατή με OpenAI, Anthropic ή Ollama. Μια συμβατή μορφή σημαίνει ότι το εργαλείο στέλνει αιτήματα σύμφωνα με μια κοινή προδιαγραφή API. Κατά τη σύνδεση στο OmniProxy, επιλέξτε OpenAI Compatible.

Desktop

Κάντε κλικ στο κουμπί στην επάνω αριστερή γωνία για να ανοίξετε την πλαϊνή γραμμή.
Κάντε κλικ στο Settings.
Κάντε κλικ στο Models.
Κάντε κλικ στο Configure providers.
Κάντε κλικ στο Add Custom Provider στο κάτω μέρος του παραθύρου.
Για τον τύπο παρόχου (Provider Type), επιλέξτε OpenAI Compatible. Μπορείτε να ορίσετε το Display Name σε OmniProxy. Εισαγάγετε τη διεύθυνση από την προηγούμενη ενότητα στο API URL. Εάν απαιτείται κλειδί, επιλέξτε την επιλογή που απαιτεί API Key και εισαγάγετε το κλειδί OmniProxy σας. Στα Available Models, εισαγάγετε τα ονόματα των μοντέλων, διαχωρίζοντας πολλαπλά ονόματα με κόμματα.
Κάντε κλικ στο Create Provider.

Η έκδοση επιφάνειας εργασίας δεν μπορεί προς το παρόν να ορίσει προσαρμοσμένες κεφαλίδες αιτημάτων (request headers) σε αυτό το παράθυρο. Εάν χρειάζεστε κεφαλίδες αιτημάτων, επεξεργαστείτε το αρχείο διαμόρφωσης αφού δημιουργήσετε τον Πάροχο.

Τερματικό

Εκτελέστε:

goose configure

Επιλέξτε Custom Providers και, στη συνέχεια, επιλέξτε Add A Custom Provider. Για τον τύπο API (API Type), επιλέξτε OpenAI Compatible και, στη συνέχεια, ακολουθήστε τις οδηγίες για να εισαγάγετε το όνομα, το API URL, αν απαιτείται κλειδί, τα ονόματα των μοντέλων και αν υποστηρίζονται αποκρίσεις ροής (streaming).

Κατά τη χειροκίνητη διαμόρφωση στα 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, όπως φαίνεται στο παράδειγμα. Το πραγματικό όριο πλαισίου (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.

Παράθυρο

Ρυθμίσεις

Ρυθμίσεις στην πλαϊνή γραμμή
Σελίδα μοντέλων
Προσθήκη προσαρμοσμένου παρόχου

Τερματικό

goose configure

Επιλέξτε Custom Providers
Στη συνέχεια, επιλέξτε προσθήκη
Επιλέξτε OpenAI Compatible ως τύπο

Αρχείο

custom_providers

Σε macOS και Linux, βρίσκεται κάτω από το ~/.config
Στα Windows, βρίσκεται κάτω από το APPDATA
Ορίστε το base_url σύμφωνα με το επίσημο παράδειγμα

Και οι τρεις μέθοδοι δημιουργούν τον ίδιο τύπο διαμόρφωσης. Επιλέξτε OpenAI Compatible ως τύπο Παρόχου.

Επαλήθευση με μια πραγματική εργασία

Ανοίξτε έναν κατάλογο που περιέχει ένα κανονικό αρχείο και εκτελέστε το goose session όπως φαίνεται στην προηγούμενη ενότητα. Ζητήστε του να διαβάσει την πρώτη γραμμή ενός αρχείου που θα καθορίσετε. Θα πρέπει να επιστρέψει τα περιεχόμενα του αρχείου αντί να πει απλώς ότι η διαμόρφωση αποθηκεύτηκε.

Για να διαβάσετε αρχεία ή να εκτελέσετε εντολές, η συνεδρία χρειάζεται την επέκταση Developer. Η επέκταση Developer είναι μια ενότητα εργαλείων που επιτρέπει στο goose να εργάζεται με τοπικά αρχεία και εντολές. Συνήθως περιλαμβάνεται στην προεπιλεγμένη διαμόρφωση. Εάν το goose πει ότι δεν διαθέτει εργαλεία αρχείων, προσθέστε τα ακόλουθα στην εντολή:

--with-builtin developer

Μην προσθέσετε επίσης το --no-profile, επειδή αυτή η επιλογή απενεργοποιεί τις προεπιλεγμένες επεκτάσεις.

Κατά τις δοκιμές στις 2026-10-09, το goose 1.54.0 διάβασε επιτυχώς την πρώτη γραμμή του καθορισμένου αρχείου. Η πρώτη απόκριση μπορεί να διαρκέσει περίπου ένα λεπτό.

Στη συνέχεια, ελέγξτε τα αρχεία καταγραφής αιτημάτων του OmniProxy για να επιβεβαιώσετε την πηγή και το όνομα του μοντέλου.

Εκκίνηση

Ανοίγει μια συνεδρία

goose session
Ο Πάροχος είναι αυτός που μόλις προστέθηκε
Το όνομα του μοντέλου βρίσκεται στη λίστα

Εργασία

Ολοκλήρωσε πραγματικά την εργασία

Για παράδειγμα, παραθέστε τον τρέχοντα κατάλογο
Ελέγξτε την απόκρισή του
Μην βασίζεστε μόνο σε μια επιτυχημένη αποθήκευση

Αρχεία καταγραφής (Logs)

Ορατά στην πύλη

Χρησιμοποιήστε τη διεύθυνση από το παράδειγμα τεκμηρίωσης
Μην τοποθετείτε το κλειδί στο αποθετήριο
Το αναγνωριστικό μοντέλου ταιριάζει με τη λίστα

Μετά την αποθήκευση του Παρόχου, επιβεβαιώστε τον με μια πραγματική συνεδρία.

Συνήθη σφάλματα

Η εντολή goose δεν μπορεί να βρεθεί: Προσθέστε τον κατάλογο εγκατάστασης στο PATH όπως περιγράφεται στη σελίδα εγκατάστασης και, στη συνέχεια, ανοίξτε ξανά το τερματικό.
Δεν εμφανίζεται παράθυρο στην έκδοση επιφάνειας εργασίας σε Mac M3: Ελέγξτε τα δικαιώματα ανάγνωσης και εγγραφής για το ~/.config.
Η κλειδοθήκη αποτυγχάνει: Μην αποθηκεύετε το κλειδί στην κλειδοθήκη· χρησιμοποιήστε αντ’ αυτού μια μεταβλητή περιβάλλοντος.
Το μοντέλο δεν βρίσκεται στη λίστα: Στην έκδοση επιφάνειας εργασίας, επιλέξτε Use custom model και εισαγάγετε το όνομα του μοντέλου χειροκίνητα. goose configure δεν μπορεί να δεχτεί ένα προσαρμοσμένο όνομα μοντέλου. Για χρήση τερματικού, μεταβείτε στην έκδοση επιφάνειας εργασίας ή επεξεργαστείτε το GOOSE_MODEL απευθείας στη διαμόρφωση.
Η διεύθυνση δεν είναι προσβάσιμη: Επιβεβαιώστε ότι το API URL τελειώνει σε /v1/chat/completions, όπως στο παράδειγμα, και ότι το OmniProxy εκτελείται.
Λέει ότι δεν μπορεί να διαβάσει αρχεία: Προσθέστε την επέκταση Developer και μην χρησιμοποιείτε το --no-profile.
Επιστρέφει unsupported Responses role: system: Η διεύθυνση είναι συνήθως σωστή. Μεταβείτε σε ένα άλλο πλήρες αναγνωριστικό από τη λίστα μοντέλων.

Επίσημες αναφορές

Για εγκατάσταση, δείτε Εγκατάσταση goose. Για προσαρμοσμένους Παρόχους, δείτε πάροχοι goose. Για τα αναγνωριστικά μοντέλων που χρησιμοποιούνται στα παραδείγματα, δείτε τη σελίδα μοντέλων xAI και το GPT-6 Luna.

Αντικαταστήστε κάθε θέση με τιμές από τη δική σας ρύθμιση OmniProxy. Ποτέ μην δημοσιεύετε πραγματικό κλειδί.

Ένα αποθηκευμένο αποτέλεσμα ή HTTP 200 μόνο του δεν αποδεικνύει πλήρη συμβατότητα Πράκτορα. Ελέγξτε την πηγή και το μοντέλο στην καταγραφή κλήσεων του OmniProxy.

Επίσημες πηγές · goose ↗