Εγκατάσταση του Pi και ρύθμιση του OmniProxy

Το Pi είναι ένας μικρός βοηθός τερματικού—ένα πρόγραμμα που συνομιλεί μαζί σας απευθείας στη γραμμή εντολών, διαβάζει αρχεία και ολοκληρώνει εργασίες. Έχει ένα σύντομο prompt συστήματος και μόνο λίγα εργαλεία από προεπιλογή. Εάν χρειάζεστε άλλες εντολές, ροές εργασίας ή διεπαφές, μπορείτε να τις προσθέσετε αργότερα μέσω επεκτάσεων. Οι επεκτάσεις είναι στοιχεία που προσθέτουν δυνατότητες στο Pi και μπορείτε να τις μοιραστείτε με άλλους αφού τις δημιουργήσετε.

Οι υπο-πράκτορες (subagents) αναθέτουν μέρος μιας εργασίας σε έναν άλλο βοηθό, ενώ η λειτουργία σχεδιασμού (plan mode) οργανώνει τα βήματα πριν ξεκινήσει η εκτέλεση. Καμία δυνατότητα δεν περιλαμβάνεται από προεπιλογή, αλλά μπορείτε να ζητήσετε από το Pi να τις δημιουργήσει ή να εγκαταστήσετε πακέτα που μοιράζονται άλλοι.

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

Το macOS και το Linux χρησιμοποιούν ένα σενάριο εγκατάστασης—μια ενιαία εντολή που κατεβάζει και εγκαθιστά αυτόματα το Pi. Στα Windows, χρησιμοποιήστε την εντολή PowerShell που παρέχεται στην αρχική σελίδα του Pi. Το PowerShell είναι το περιβάλλον γραμμής εντολών που περιλαμβάνεται στα Windows. Μπορείτε επίσης να εγκαταστήσετε το Pi στο WSL, το περιβάλλον Linux που είναι διαθέσιμο εντός των Windows.

Εάν επιλέξετε να εγκαταστήσετε με npm, χρειάζεστε Node.js 22.19 ή μεταγενέστερη έκδοση. Το npm είναι ο διαχειριστής πακέτων που χρησιμοποιείται με το Node.js και μπορεί να εγκαταστήσει το Pi από τη γραμμή εντολών.

macOS Linux

install.sh

curl το επίσημο σενάριο
Το πρόγραμμα εγκατάστασης καρφιτσώνει τις εξαρτήσεις
Ενημέρωση με pi update

Windows

install.ps1

Επίσημη εντολή PowerShell
Το Git for Windows παρέχει Bash
Μπορείτε επίσης να χρησιμοποιήσετε WSL

Το Node είναι ήδη εγκατεστημένο

npm

Απαιτεί Node 22.19+
Το όνομα του πακέτου είναι pi-coding-agent
Προσθέστε --ignore-scripts

Το σενάριο εγκατάστασης καρφιτσώνει τις εξαρτήσεις. Η εγκατάσταση npm δεν καρφιτσώνει τις μεταβατικές εξαρτήσεις και απαιτεί --ignore-scripts.

Εγκατάσταση και εκκίνηση του Pi για πρώτη φορά

Σε macOS ή Linux, ανοίξτε ένα τερματικό και εκτελέστε:

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

Στα Windows, ανοίξτε το PowerShell και εκτελέστε:

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

Εάν το Node.js 22.19 ή μεταγενέστερη έκδοση είναι ήδη εγκατεστημένο, μπορείτε επίσης να χρησιμοποιήσετε την εναλλακτική εντολή από το Quickstart:

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

Το σενάριο εγκατάστασης μπορεί να κάνει παύση για να κάνει ερωτήσεις σε ένα διαδραστικό τερματικό. Ακολουθήστε τις προτροπές στην οθόνη για να συνεχίσετε. Εάν έχετε ήδη μια συμβατή έκδοση του Node, αυτή η εντολή npm δεν θα κάνει ερωτήσεις. Για να εγκαταστήσετε το Pi σε άλλον κατάλογο, προσθέστε το --prefix /your/directory. Στις 09-10-2026, αυτό εγκατέστησε το Pi 1.1.0.

Μια κανονική εγκατάσταση npm δεν απαιτεί σενάρια κύκλου ζωής εξαρτήσεων, τα οποία είναι σενάρια που εκτελούν τα πακέτα αυτόματα κατά την εγκατάσταση. Το σενάριο εγκατάστασης καρφιτσώνει τις εξαρτήσεις· στη συνέχεια, ενημερώστε το Pi με pi update. Για μια εγκατάσταση npm, χρησιμοποιήστε τη μέθοδο ενημέρωσης που παρέχεται από τον διαχειριστή πακέτων σας. Οι χρήστες Nix θα πρέπει να εγκαταστήσουν από το flake του Pi. Ένα flake είναι μια διαμόρφωση Nix που περιγράφει το λογισμικό και τις εξαρτήσεις του, και το pi update δεν μπορεί να ενημερώσει μια εγκατάσταση Nix.

Μετά την εγκατάσταση, επιβεβαιώστε πρώτα ότι το τερματικό σας μπορεί να βρει το Pi:

pi --version

Στα Windows, εάν θέλετε τα μοντέλα να εκτελούν εντολές 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 σε αυτό το περιβάλλον Linux ακολουθώντας το Quickstart.

Στη συνέχεια, εισαγάγετε τον φάκελο που θέλετε να επιθεωρήσει ή να εργαστεί το 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 είναι το τελικό σημείο API στο οποίο το Pi στέλνει αιτήματα και πρέπει να περιλαμβάνει το /v1. apiKey είναι το κλειδί που χρησιμοποιείται για την πρόσβαση στο API. Model ID είναι το όνομα του μοντέλου που θα κληθεί και πρέπει να αντιγραφεί πλήρως από την τρέχουσα λίστα μοντέλων του OmniProxy.

Ορίστε το api σε openai-completions, όπως φαίνεται στο παράδειγμα συμβατού API. Αυτό το πεδίο λέει στο Pi ποια μορφή API να χρησιμοποιήσει κατά την αποστολή αιτημάτων.

Αντιγράψτε ολόκληρο το αναγνωριστικό μοντέλου, συμπεριλαμβανομένων τυχόν καθέτων στο όνομα. Στις 09-10-2026, τα δύο αναγνωριστικά αναφοράς στην τεκμηρίωση του παρόχου ήταν 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 κάθε μοντέλου πρέπει να ταιριάζει με το πλήρες Model ID στην τρέχουσα λίστα μοντέλων του OmniProxy. input υποδεικνύει ότι το μοντέλο έχει ρυθμιστεί εδώ για είσοδο κειμένου.

Το

apiKey μπορεί να εισαχθεί ως κυριολεκτική τιμή ή ως $NAME ή ${NAME} ώστε το Pi να το διαβάσει από μια μεταβλητή περιβάλλοντος. Μια τιμή που ξεκινά με ! αντιμετωπίζεται ως εντολή και εκτελείται για κάθε αίτημα. Μην δεσμεύετε ένα πραγματικό κλειδί σε ένα αποθετήριο. Εάν το gateway δεν επικυρώνει κλειδιά, μπορείτε να εισαγάγετε μια συμβολοσειρά κράτησης θέσης που χρησιμοποιείται μόνο στον τοπικό σας υπολογιστή. Στις 09-10-2026, το Pi διάβασε με επιτυχία το αρχείο με αυτήν τη διαμόρφωση.

Το άνοιγμα του /model φορτώνει ξανά αυτό το αρχείο. /model είναι η διεπαφή στο Pi για την προβολή και επιλογή μοντέλων. Τα προσαρμοσμένα μοντέλα δεν εμφανίζονται στο /model μέχρι το Pi να μπορέσει να επιλύσει τα διαπιστευτήριά τους. Μετά την επιλογή ενός μοντέλου, πατήστε Ctrl+S για να το αποθηκεύσετε ως το προεπιλεγμένο μοντέλο για νέες συνεδρίες.

Αρχείο

models.json

Προεπιλεγμένος κατάλογος: ~/.pi/agent
Προσθέστε μια καταχώρηση κάτω από το providers
Ορίστε το api σε completions

Διεύθυνση

baseUrl

Συμπεριλάβετε το /v1
Το apiKey μπορεί να αναφέρεται σε μεταβλητή
Το model id πρέπει να είναι ακριβές

Επιλογή

/model

Το άνοιγμά του φορτώνει ξανά το αρχείο
Επιλέξτε το μοντέλο που μόλις προσθέσατε
Το Ctrl+S το αποθηκεύει ως προεπιλογή

Μετά την επεξεργασία του αρχείου, ανοίξτε το /model στο Pi και επιβεβαιώστε ότι τα μοντέλα εμφανίζονται.

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

Μετά την ολοκλήρωση της διαμόρφωσης, μπορείτε να εκτελέσετε έναν μη διαδραστικό έλεγχο σε έναν κατάλογο που περιέχει αρχεία. Η μη διαδραστική λειτουργία σημαίνει ότι το 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 να μην τροποποιήσει το αρχείο. Στις 09-10-2026, το Pi 1.1.0 διάβασε τα περιεχόμενα του αρχείου με επιτυχία. Η πρώτη απόκριση διήρκεσε περίπου δύο λεπτά.

Μπορείτε επίσης να χρησιμοποιήσετε τη διαδραστική λειτουργία: εισαγάγετε τον κατάλογο, εκτελέστε το pi, και στη συνέχεια επιλέξτε ένα μοντέλο με το /model. Μια εργασία παραδείγματος στο Quickstart ζητά από το Pi να εξηγήσει πώς είναι οργανωμένο το αποθετήριο και πώς να εκτελέσετε τους ελέγχους του. Παρατηρήστε αν διαβάζει τα αρχεία και παρέχει μια εξήγηση, στη συνέχεια επιβεβαιώστε την πηγή και το αναγνωριστικό μοντέλου στα αρχεία καταγραφής αιτημάτων του OmniProxy.

Εκκίνηση

Το pi εκκινείται

Πρώτα cd στον φάκελο
Το pi --version παράγει έξοδο
Το όνομα του μοντέλου εμφανίζεται στο κάτω μέρος της διεπαφής

Εργασία

Διάβασε τον κατάλογο

Ρωτήστε πώς είναι οργανωμένο το αποθετήριο
Επανεξετάστε τα αρχεία που παραθέτει
Μην βασίζεστε μόνο σε μια επιτυχημένη αποθήκευση διαμόρφωσης

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

Ορατό στο gateway

Η πηγή είναι το Pi
Το Model ID ταιριάζει
Διατηρήστε το κλειδί στον τοπικό υπολογιστή

Αφού εμφανιστεί το όνομα του μοντέλου στο κάτω μέρος της διεπαφής, ολοκληρώστε επίσης μία πραγματική εργασία.

Κοινά σφάλματα

Το pi δεν μπορεί να βρεθεί: Ανοίξτε ξανά το τερματικό και δοκιμάστε το pi --version ξανά. Για μια εγκατάσταση npm, επιβεβαιώστε ότι ο κατάλογος global bin βρίσκεται στο PATH.
Τα προσαρμοσμένα μοντέλα δεν εμφανίζονται στο /model: Επιβεβαιώστε ότι το models.json βρίσκεται στο ~/.pi/agent/, επαληθεύστε ότι το apiKey μπορεί να επιλυθεί και στη συνέχεια ανοίξτε ξανά το /model.
Τα Windows αναφέρουν ότι το Bash δεν μπορεί να βρεθεί: Εγκαταστήστε το Git for Windows ή ορίστε το shellPath στο ~/.pi/agent/settings.json. Οι ανάστροφες κάθετοι στο JSON πρέπει να γράφονται δύο φορές.
Το αίτημα απορρίπτεται: Ελέγξτε ότι το api είναι openai-completions και ότι το baseUrl τελειώνει σε /v1. Μην ενεργοποιείτε πρόσθετες επιλογές συμβατότητας απλώς επειδή η υπηρεσία περιγράφει τον εαυτό της ως συμβατή.
Το αναγνωριστικό μοντέλου είναι άκυρο: Αντιγράψτε το ξανά από την τρέχουσα λίστα του OmniProxy.

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

Για εντολές εγκατάστασης, δείτε τον Pi website και το Quickstart. Για το αρχείο μοντέλου, δείτε το Choose a Model και το Configuration. Για το περιβάλλον εντολών των Windows, δείτε το Run Pi on Windows. Για τα αναγνωριστικά μοντέλων που χρησιμοποιούνται στα παραδείγματα, δείτε το Gemini model list και xAI models page.

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

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

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