Εγκατάσταση του Mistral Vibe CLI
Σε αυτήν τη σελίδα
Προαπαιτούμενα
Πριν εγκαταστήσετε το Vibe, βεβαιωθείτε ότι το σύστημά σας διαθέτει Python 3.12 ή νεότερη έκδοση. Αυτή είναι η μοναδική υποχρεωτική τεχνική εξάρτηση και αποτελεί επίσης την πιο συχνή αιτία αποτυχίας: πολλά συστήματα Linux εξακολουθούν να παρέχουν προεπιλεγμένα την Python 3.10 ή 3.11. Ξεκινήστε ελέγχοντας την έκδοσή σας:
python3 --version
# or on some systems
python --version
Εάν δείτε έκδοση χαμηλότερη από την 3.12, ενημερώστε την Python από τον επίσημο ιστότοπο ή μέσω του διαχειριστή πακέτων σας. Μην προχωρήσετε πριν διορθώσετε αυτό το ζήτημα: μια εγκατάσταση που εκτελείται σε παλαιότερη έκδοση αποτυγχάνει με σφάλμα επίλυσης εξαρτήσεων που δεν υποδεικνύει την πραγματική αιτία.
Εγκατάσταση σε Mac και Linux
Η ταχύτερη μέθοδος σε Mac και Linux είναι το επίσημο σενάριο εγκατάστασης. Χρειάζεστε μόνο μία εντολή:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Αυτό το σενάριο ανιχνεύει το σύστημά σας, εγκαθιστά το uv—τον εξαιρετικά γρήγορο διαχειριστή πακέτων Python—εάν είναι απαραίτητο, και στη συνέχεια εγκαθιστά το Vibe ως παγκόσμιο εργαλείο. Μόλις ολοκληρωθεί, η εντολή vibe είναι διαθέσιμη στο τερματικό σας.
Εναλλακτική με το uv
Εάν χρησιμοποιείτε ήδη το uv, μπορείτε να εγκαταστήσετε το Vibe απευθείας χωρίς να εκτελέσετε το σενάριο:
uv tool install mistral-vibe
Το uv διαχειρίζεται αυτόματα το εικονικό περιβάλλον και τις εξαρτήσεις. Αυτή είναι η προτεινόμενη μέθοδος εάν εργάζεστε σε πολλαπλά έργα Python και θέλετε να αποφύγετε συγκρούσεις: το Vibe λειτουργεί στο δικό του απομονωμένο περιβάλλον και δεν θα αντικαταστήσει ποτέ μια έκδοση βιβλιοθήκης από την οποία εξαρτάται κάποιο από τα έργα σας.
Εναλλακτική με το pip
Για μια κλασική εγκατάσταση μέσω pip:
pip install mistral-vibe
Αυτό λειτουργεί, αλλά εγκαθιστά το Vibe στο τρέχον περιβάλλον Python, ενέχοντας τον κίνδυνο συγκρούσεων. Εάν αντιμετωπίσετε συγκρούσεις εξαρτήσεων, απομονώστε το εργαλείο σε ένα αφιερωμένο εικονικό περιβάλλον:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Λάβετε υπόψη ότι με αυτή την προσέγγιση, η εντολή vibe είναι διαθέσιμη μόνο όταν το περιβάλλον είναι ενεργοποιημένο.
Εγκατάσταση σε Windows
Τα Windows υποστηρίζονται, αν και το Vibe έχει σχεδιαστεί κυρίως για περιβάλλοντα UNIX. Η εγκατάσταση γίνεται μέσω PowerShell σε δύο βήματα: η πρώτη εντολή εγκαθιστά το uv και η δεύτερη εγκαθιστά το Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Μετά την εγκατάσταση, ανοίξτε ένα νέο τερματικό ώστε να αναγνωριστεί η εντολή vibe: η τρέχουσα συνεδρία PowerShell διατηρεί την παλιά διαδρομή PATH και θα σας ενημερώσει ότι η εντολή δεν υπάρχει, παρόλο που έχει εγκατασταθεί.
Windows με WSL
Εάν χρησιμοποιείτε το WSL (Windows Subsystem for Linux), ακολουθήστε απλώς τις οδηγίες για Mac/Linux. Αυτή είναι στην πραγματικότητα η συνιστώμενη μέθοδος για βέλτιστη εμπειρία στα Windows, καθώς οι εντολές κελύφους που εκτελεί ο πράκτορας έχουν σχεδιαστεί για περιβάλλον UNIX:
# In your WSL terminal
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Επαλήθευση της Εγκατάστασης
Ανεξάρτητα από τη μέθοδο που χρησιμοποιήσατε, ολοκληρώστε πάντα με μια επαλήθευση. Αυτός είναι ο μόνος τρόπος για να γνωρίζετε εάν το εκτελέσιμο αρχείο είναι πραγματικά προσβάσιμο από το κέλυφός σας:
vibe --version
Θα πρέπει να δείτε τον αριθμό έκδοσης να εμφανίζεται (3.0.4 από τις 2 Νοεμβρίου 2026· η γενιά 3.0 χρονολογείται από τις 19 Οκτωβρίου 2026). Εάν η εντολή δεν βρεθεί, σχεδόν ποτέ δεν σημαίνει ότι η εγκατάσταση απέτυχε: σημαίνει ότι ο κατάλογος εγκατάστασης δεν περιλαμβάνεται στο PATH σας.
Αντιμετώπιση Συχνών Προβλημάτων
Η εντολή vibe δεν βρέθηκε
Μετά την εγκατάσταση μέσω uv, το εκτελέσιμο αρχείο βρίσκεται συνήθως στο ~/.local/bin/. Εάν αυτός ο κατάλογος δεν δηλώνεται στο PATH σας, το κέλυφός σας δεν μπορεί να τον εντοπίσει. Προσθέστε τον στο αρχείο διαμόρφωσής σας:
# In ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Στη συνέχεια, επαναφορτώστε το κέλυφός σας ώστε η αλλαγή να ισχύσει για την τρέχουσα συνεδρία:
source ~/.bashrc
# or
source ~/.zshrc
Σφάλμα προσωρινής μνήμης με το uv
Μερικές φορές μια προηγούμενη εγκατάσταση αφήνει μια κατεστραμμένη προσωρινή μνήμη, συνήθως μετά από διακοπή δικτύου. Η εγκατάσταση τότε αποτυγχάνει με ένα σφάλμα που αναφέρει την προσωρινή μνήμη. Επαναλάβετε την εντολή παρακάμπτοντάς την:
uv tool install mistral-vibe --no-cache
Σύγκρουση έκδοσης Python
Σε ένα μηχάνημα όπου συνυπάρχουν πολλαπλοί διερμηνευτές—για παράδειγμα, μια Python 3.11 συστήματος και μια χειροκίνητα εγκατεστημένη 3.12—το uv ενδέχεται να επιλέξει τη λανθασμένη. Επιβάλετε ρητά την επιθυμητή έκδοση:
uv tool install mistral-vibe --python python3.12
Αυτές οι τρεις περιπτώσεις καλύπτουν σχεδόν όλες τις εγκαταστάσεις που έχουν κολλήσει. Κάντε συνήθεια να εκτελείτε ξανά την vibe --version μετά από κάθε διόρθωση.
Βασικά σημεία
- Η Python 3.12+ είναι το μοναδικό τεχνικό προαπαιτούμενο
- Σε Mac/Linux, το σενάριο
curlείναι η ταχύτερη μέθοδος - Το
uv tool installείναι η συνιστώμενη μέθοδος για την αποφυγή συγκρούσεων - Στα Windows, προτιμήστε το WSL για καλύτερη εμπειρία
- Επαληθεύστε την εγκατάσταση με την
vibe --version