Εγκατάσταση του Hermes και διαμόρφωση του OmniProxy

Το Hermes είναι ένας βοηθός που μπορεί να διατηρεί συνομιλίες και εμπειρία εργασιών, μετατρέποντας την ολοκληρωμένη εργασία σε δεξιότητες που μπορούν να επαναχρησιμοποιηθούν αργότερα. Μέσω μιας ενιαίας Πύλης (Gateway), μπορεί επίσης να συνδεθεί με Telegram, Discord, Slack, WhatsApp, Signal και το τερματικό. Η Πύλη χρησιμεύει ως ενιαίο σημείο εισόδου για τη λήψη και προώθηση μηνυμάτων. Μπορείτε να του στείλετε κριτικές κώδικα, σημειώσεις περιστατικών ή υλικό πελατών από τα συνηθισμένα εργαλεία συνομιλίας σας και, στη συνέχεια, να τον αφήσετε να επιστρέψει στο αποθετήριο και να συνεχίσει να εργάζεται.

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

Πρώτα, επιλέξτε μια μέθοδο εγκατάστασης με βάση το λειτουργικό σύστημα του υπολογιστή σας. Τα macOS και Windows μπορούν να χρησιμοποιήσουν απευθείας γραφικά προγράμματα εγκατάστασης, ενώ το Linux, το macOS και το WSL2 μπορούν να χρησιμοποιήσουν ένα σενάριο τερματικού. Το WSL2 είναι μια δυνατότητα των Windows για την εκτέλεση περιβάλλοντος Linux. Το Termux σε τηλέφωνα Android και το Docker έχουν τις δικές τους μεθόδους εγκατάστασης, αλλά αυτός ο οδηγός καλύπτει μόνο την εγκατάσταση σε κανονικούς υπολογιστές.

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

macOS, Windows

• macOS: ανοίξτε το DMG
• Windows: ανοίξτε το πρόγραμμα εγκατάστασης
• Εγκαταστήστε την εφαρμογή στο σύστημα

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

Linux, macOS, WSL2

• Μία εντολή install.sh
• Χρησιμοποιήστε το install.ps1 στα Windows
• Εισαγάγετε hermes μετά την εγκατάσταση

Μην τα χρησιμοποιείτε ακόμη

pip, brew, AUR

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

Πριν ξεκινήσετε, προετοιμάστε έναν υπολογιστή macOS, Windows ή Linux και βεβαιωθείτε ότι μπορεί να ανοίξει ένα τερματικό και να αποκτήσει πρόσβαση στο GitHub. Εάν σκοπεύετε να εγκαταστήσετε το Hermes σε εξωτερικό δίσκο, συνδέστε πρώτα τον δίσκο και επιβεβαιώστε ότι έχει αρκετό ελεύθερο χώρο.

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

Εάν θέλετε μια γραφική εφαρμογή

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

• macOS: Ανοίξτε το DMG και μετακινήστε το Hermes.app στις Εφαρμογές. Ένα DMG είναι μια εικόνα εγκατάστασης που χρησιμοποιείται συνήθως στο macOS. Αυτό το πρόγραμμα εγκατάστασης υποστηρίζει μόνο Apple silicon· οι Intel Mac δεν υποστηρίζονται.
• Windows: Ανοίξτε το .appinstaller αρχείο με το Windows App Installer. Εγκαθιστά ένα υπογεγραμμένο MSIX, έναν τύπο πακέτου εφαρμογής που χρησιμοποιείται από τα Windows.
• Linux: Τα προγράμματα εγκατάστασης επιφάνειας εργασίας είναι για macOS και Windows. Στο Linux, χρησιμοποιήστε την παρακάτω εντολή τερματικού. Μετά την εγκατάσταση, μπορείτε να εκτελέσετε το hermes desktop.

Εάν χρειάζεστε μόνο το τερματικό

Εάν χρησιμοποιείτε Linux, macOS ή WSL2, εκτελέστε αυτό σε ένα τερματικό:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Όταν χρησιμοποιείτε το PowerShell που περιλαμβάνεται στα Windows, εκτελέστε:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Το πρόγραμμα εγκατάστασης κατεβάζει τον κώδικα του Hermes και τα προγράμματα που απαιτούνται για την εκτέλεσή του. Εάν η λήψη διακοπεί, εκτελέστε την ίδια εντολή ξανά. Αφού ολοκληρωθεί η εγκατάσταση, κλείστε το τρέχον τερματικό, ανοίξτε ένα νέο παράθυρο και εισαγάγετε:

hermes

Εάν δείτε το prompt του Hermes, η εντολή είναι έτοιμη για χρήση. Στη συνέχεια, μπορείτε να εκτελέσετε το hermes doctor· αυτός ο έλεγχος εγκατάστασης σας λέει τι λείπει ακόμη.

Αποθήκευση του προγράμματος σε εξωτερικό δίσκο

Στις 9 Οκτωβρίου 2026, το Hermes Agent v0.21.6 εγκαταστάθηκε σε έναν εξωτερικό δίσκο συνδεδεμένο σε Mac. Το πρόγραμμα αποθηκεύτηκε στο /Volumes/AItools/tools/hermes-agent, η εντολή εκκίνησης βρισκόταν στο ~/.local/bin/hermesκαι τα δεδομένα διαμόρφωσης και συνομιλίας παρέμειναν στο ~/.hermes.

Εάν ο δίσκος σας έχει διαφορετικό όνομα, αντικαταστήστε τη διαδρομή μετά το --dir με τον δικό σας φάκελο. Ο δίσκος πρέπει να παραμένει συνδεδεμένος όσο εκτελείται το Hermes.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Πρόγραμμα

Εξωτερικός δίσκος

• tools/hermes-agent
• Κρατήστε τον κώδικα εδώ

Εντολή

~/.local/bin/hermes

• Εισαγάγετε hermes στο τερματικό
• Τίθεται σε ισχύ μετά το άνοιγμα ενός νέου παραθύρου

Διαμόρφωση και συνομιλίες

~/.hermes

• Το config.yaml βρίσκεται εδώ
• Έξοδος πριν από την αποσύνδεση του δίσκου

Λήψη τιμών σύνδεσης από το OmniProxy

Εδώ, το Hermes συνδέεται στο OmniProxy αντί απευθείας στο Grok ή το Gemini. Διαμορφώστε τα URL των υπηρεσιών Grok και Gemini στο OmniProxy· μην τα εισάγετε απευθείας στο Hermes.

Ο υπολογιστής σας

Hermes

→

Τοπική πύλη

OmniProxy

• Συμπεριλάβετε το /v1 στη διεύθυνση

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Ένα αναγνωριστικό μοντέλου είναι το ακριβές όνομα που χρησιμοποιεί το API για να αναγνωρίσει ένα μοντέλο. Χρησιμοποιήστε τα ακόλουθα ονόματα για τα δύο μοντέλα:

• Για το Grok, εισαγάγετε grok-4.7. Το xAI API είναι https://api.x.ai/v1, και τα αιτήματα συνομιλίας χρησιμοποιούν το /v1/chat/completions. Δείτε την τεκμηρίωση μοντέλου Grok.
• Για το Gemini, εισαγάγετε gemini-3.8-flash. Το συμβατό με OpenAI API της Google είναι https://generativelanguage.googleapis.com/v1beta/openai/. Δείτε την τεκμηρίωση συμβατότητας OpenAI του Gemini.

Για να μεταφέρετε το Hermes στο Gemini, αλλάξτε μόνο το όνομα του μοντέλου σε gemini-3.8-flash. Συνεχίστε να χρησιμοποιείτε τη διεύθυνση OmniProxy ως API endpoint.

Αντιγράψτε το URL του endpoint και το κλειδί από το OmniProxy και, στη συνέχεια, εισαγάγετε το αντίστοιχο αναγνωριστικό μοντέλου:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Το Base URL είναι το endpoint στο οποίο το Hermes στέλνει αιτήματα. Πρέπει να τελειώνει με /v1 εδώ. Το API Key είναι το κλειδί που εκδίδει το OmniProxy στο Hermes. Αντικαταστήστε το placeholder με τη δική σας τιμή και μην το δημοσιεύσετε σε δημόσια σελίδα.

Εάν η τοπική σας περίπτωση OmniProxy δεν απαιτεί κλειδί, μπορείτε να αφήσετε το API Key κενό. Εάν η διεύθυνση είναι προσβάσιμη από οποιονδήποτε άλλον, θα πρέπει να χρησιμοποιήσετε ένα κλειδί. Επιβεβαιώστε επίσης ότι η διεύθυνση είναι προσβάσιμη από το περιβάλλον όπου εκτελείται το Hermes. Εάν το Hermes και το OmniProxy βρίσκονται στον ίδιο υπολογιστή, μπορείτε να χρησιμοποιήσετε μια τοπική διεύθυνση.

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

Πρώτα, βγείτε από την τρέχουσα συνομιλία και, στη συνέχεια, εκτελέστε αυτό σε ένα τερματικό:

hermes model

Επιλέξτε Custom endpoint (self-hosted / VLLM / etc.). Το Custom endpoint σημαίνει ότι το Hermes συνδέεται σε μια διεύθυνση υπηρεσίας που καθορίζετε εσείς αντί να χρησιμοποιεί έναν προκαθορισμένο πάροχο.

Ο οδηγός εγκατάστασης ζητά το URL του endpoint, το κλειδί και το όνομα του μοντέλου με τη σειρά. Εισαγάγετε τις τρεις τιμές από την προηγούμενη ενότητα. Για να χρησιμοποιήσετε το Gemini, εισαγάγετε gemini-3.8-flash ως όνομα μοντέλου.

Μπορείτε επίσης να επεξεργαστείτε το ~/.hermes/config.yaml απευθείας. Το YAML είναι μια μορφή κειμένου που χρησιμοποιεί εσοχές για να αναπαραστήσει σχέσεις διαμόρφωσης. Η ακόλουθη διαμόρφωση χρησιμοποιεί το Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Για να χρησιμοποιήσετε το Gemini, αλλάξτε το default σε gemini-3.8-flash και αφήστε τις άλλες τρεις τιμές αμετάβλητες:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Μετά την αποθήκευση, εκτελέστε το hermes ξανά και ξεκινήστε μια νέα συνομιλία. Σε μια ήδη ανοιχτή συνεδρία, /model μπορεί μόνο να κάνει εναλλαγή μεταξύ παρόχων που έχουν ήδη αποθηκευτεί· δεν μπορεί να προσθέσει αυτή τη διαμόρφωση.

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

1

hermes doctor

• Ο έλεγχος εγκατάστασης περνά

2

Στείλτε ένα σύντομο μήνυμα

• Δείτε μια απάντηση από το Hermes

3

Ανοίξτε τα αρχεία καταγραφής αιτημάτων

• Επαληθεύστε το όνομα του μοντέλου

1. Εκτελέστε το hermes doctor για να ελέγξετε αν η εγκατάσταση είναι πλήρης.
2. Εκτελέστε το hermes και ζητήστε του να εξηγήσει με μία πρόταση τι μπορεί να κάνει. Θα πρέπει να δείτε μια απόκριση.
3. Ανοίξτε το αρχείο καταγραφής αιτημάτων του OmniProxy, επιβεβαιώστε ότι το αίτημα προήλθε από το Hermes και ελέγξτε αν το όνομα του μοντέλου είναι grok-4.7 ή gemini-3.8-flash.

Το να βλέπετε ότι ο οδηγός εγκατάστασης αποθηκεύτηκε επιτυχώς ή ότι το API επέστρεψε μια επιτυχημένη απόκριση, δεν αρκεί για να δείξει ότι το Hermes μπορεί να ολοκληρώσει εργασίες για εσάς. Το όνομα του μοντέλου στο αρχείο καταγραφής αιτημάτων πρέπει να ταιριάζει με την τιμή που εισαγάγατε.

Για να συνομιλήσετε σε ένα πρόγραμμα περιήγησης, εκτελέστε τα ακόλουθα τοπικά:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Στη συνέχεια, ανοίξτε το http://127.0.0.1:9119. Αυτή η διεύθυνση λειτουργεί μόνο στον τρέχοντα υπολογιστή.

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

• Η εισαγωγή του hermes αναφέρει ότι η εντολή δεν μπορεί να βρεθεί: Κλείστε το τερματικό και ανοίξτε ένα νέο παράθυρο. Εάν η εντολή εξακολουθεί να μην βρίσκεται, επιβεβαιώστε ότι το ~/.local/bin βρίσκεται στο PATH. Το PATH είναι η λίστα των καταλόγων όπου το σύστημα αναζητά εντολές. Στα Windows, επιβεβαιώστε ότι ο κατάλογος εκκίνησης που προστέθηκε από το πρόγραμμα εγκατάστασης βρίσκεται στο PATH.
• Η λήψη της εγκατάστασης σταματά στη μέση: Εκτελέστε την ίδια εντολή εγκατάστασης ξανά. Τα μέρη που έχουν ήδη ληφθεί θα επαναχρησιμοποιηθούν.
• Το Hermes δεν αποκρίνεται ή αναφέρει ότι δεν μπορεί να συνδεθεί: Επιβεβαιώστε ότι το OmniProxy εκτελείται και ελέγξτε ότι το Base URL τελειώνει με /v1. Εάν το Hermes εκτελείται στο Docker ενώ το OmniProxy εκτελείται στον κεντρικό υπολογιστή (host), μην χρησιμοποιείτε το 127.0.0.1 εάν είναι έγκυρο μόνο μέσα στο κοντέινερ.
• Εμφανίζεται σφάλμα κλειδιού: Ενημερώστε το κλειδί OmniProxy και, στη συνέχεια, αλλάξτε το api_key στο config.yaml. Το κλειδί xAI ή Google ανήκει στις ρυθμίσεις παρόχου του OmniProxy· μην το εισάγετε σε αυτό το πεδίο του Hermes.
• Το μοντέλο αναφέρεται ως μη διαθέσιμο: Ανοίξτε την τρέχουσα λίστα μοντέλων στο OmniProxy και αντιγράψτε το grok-4.7 ή το gemini-3.8-flash ακριβώς όπως εμφανίζεται στη λίστα.
• Το Hermes αποκρίνεται αλλά δεν μπορεί να εκτελέσει εργασίες όπως ανάγνωση αρχείων ή εκτέλεση εντολών: Μεταβείτε σε ένα άλλο μοντέλο στο OmniProxy που διαθέτει αυτές τις δυνατότητες και, στη συνέχεια, ξεκινήστε μια νέα συνεδρία Hermes.
• Το πρόγραμμα βρίσκεται σε εξωτερικό δίσκο και το hermes doctor αναφέρει σφάλμα αποθήκευσης μετά την αποσύνδεση του δίσκου: Συνδέστε πρώτα τον δίσκο. Μην αφήνετε το Hermes να δημιουργήσει ξεχωριστή διαμόρφωση ενώ ο δίσκος είναι αποσυνδεδεμένος.

Αναφορές

Για τα βήματα εγκατάστασης, δείτε την τεκμηρίωση εγκατάστασης Hermes και την υποστήριξη πλατφόρμας. Για διαμόρφωση Custom endpoint, δείτε την τεκμηρίωση Παρόχου Hermes. Για τα αναγνωριστικά μοντέλων, δείτε την τεκμηρίωση μοντέλου Grok και την τεκμηρίωση συμβατότητας OpenAI του Gemini.

Η διαδικασία εγκατάστασης σε macOS ολοκληρώθηκε στις 2026-10-09 χρησιμοποιώντας το Hermes Agent v0.21.6. grok-4.7 και gemini-3.8-flash ήταν τα τυπικά αναγνωριστικά μοντέλων στην τεκμηρίωση xAI και Google εκείνη την ημερομηνία. Κατά την εισαγωγή των τιμών, χρησιμοποιήστε τα ονόματα που εμφανίζονται στο OmniProxy.

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

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

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