Εγκατάσταση του Mistral Python SDK
Σε αυτήν τη σελίδα
Προαπαιτούμενα
Ενημερώθηκε στις 2 Νοεμβρίου 2026 — Mistral SDK 3. Αυτό το μάθημα κάλυπτε προηγουμένως την έκδοση 2 του SDK και την Python 3.9. Η τρέχουσα έκδοση είναι η 3.7.0 (κυκλοφόρησε την 1η Νοεμβρίου 2026)· απαιτεί Python 3.10 ή νεότερη, και ο πελάτης εισάγεται μέσω
from mistralai.client import Mistralαπό την έκδοση 2.0 (Μάρτιος 2026). Πηγές: mistralai στο PyPI · Σημειώσεις έκδοσης v2.0.0 · Σημειώσεις έκδοσης v3.0.0.
Η εγκατάσταση του SDK απαιτεί τρία πράγματα: Python 3.10 ή νεότερη, την οποία μπορείτε να επαληθεύσετε με python --version· ένα ενημερωμένο pip, που αποκτάται μέσω pip install --upgrade pip· και το κλειδί API του Mistral σας ήδη ορισμένο ως μεταβλητή περιβάλλοντος, όπως καλύφθηκε στο προηγούμενο μάθημα. Αν η Python δεν είναι ακόμη εγκατεστημένη στον υπολογιστή σας, κατεβάστε την τελευταία σταθερή έκδοση από το python.org ή χρησιμοποιήστε τον διαχειριστή πακέτων του συστήματός σας.
Απομονώστε το έργο σας πριν εγκαταστήσετε οτιδήποτε
Εργάζεστε πάντα μέσα σε ένα εικονικό περιβάλλον. Αυτή η συνήθεια σας γλιτώνει από έναν συχνό πονοκέφαλο: δύο έργα στον ίδιο υπολογιστή, όπου το ένα απαιτεί μια συγκεκριμένη έκδοση SDK και το άλλο μια διαφορετική, και μια απλή εντολή pip install χαλάει σιωπηλά το πρώτο έργο ενημερώνοντας το δεύτερο. Ένα εικονικό περιβάλλον παρέχει σε κάθε έργο τις δικές του απομονωμένες εξαρτήσεις, ξεχωριστά από τα πακέτα του συστήματος.
# Δημιουργία του εικονικού περιβάλλοντος
python -m venv mistral-env
# Ενεργοποίηση σε Linux / macOS
source mistral-env/bin/activate
# Ενεργοποίηση σε Windows
mistral-env\Scripts\activate
Μόλις ενεργοποιηθεί, η προτροπή του τερματικού σας θα έχει ως πρόθεμα το όνομα του περιβάλλοντος σε παρενθέσεις: (mistral-env). Αυτός ο μικρός δείκτης εγγυάται ότι οι επόμενες εντολές εφαρμόζονται στη σωστή τοποθεσία· αν δεν εμφανίζεται, μην εγκαταστήσετε τίποτα.
Εγκατάσταση του επίσημου SDK
Η εγκατάσταση του Mistral SDK απαιτεί μία μόνο εντολή:
pip install mistralai
Αυτό εγκαθιστά την τελευταία έκδοση του SDK: 3.7.0 από την 1η Νοεμβρίου 2026. Η γενιά 3 ξεκίνησε με την έκδοση 3.0, που κυκλοφόρησε στις 28 Σεπτεμβρίου 2026. Για να επιβεβαιώσετε ότι όλα είναι στη θέση τους, εκτελέστε pip show mistralai για να εμφανίσετε το όνομα του πακέτου, την έκδοση και τις εξαρτήσεις.
Μερικές φορές ένα έργο απαιτεί μια συγκεκριμένη έκδοση, για παράδειγμα, για ναδιατηρώντας ευθυγραμμισμένη μια ολόκληρη ομάδα κατά τη διάρκεια μιας μετάβασης. Μπορείτε να ορίσετε περιορισμούς σε δύο επίπεδα:
# Παραμονή εντός της γενιάς 3
pip install "mistralai>=3,<4"
# Εγκατάσταση μιας ακριβούς έκδοσης
pip install "mistralai==3.7.0"
Καθ’ οδόν, το pip τραβάει μερικές εξαρτήσεις που εμφανίζονται στη λίστα. Βοηθάει να τις αναγνωρίζετε, ιδιαίτερα το httpx2, τον πελάτη HTTP που διαχειρίζεται τις κλήσεις δικτύου (το SDK χρησιμοποιεί αυτό αντί για το httpx ξεκινώντας από την έκδοση 3.0), και το pydantic, το οποίο επικυρώνει και σειριοποιεί τα ανταλλασσόμενα δεδομένα. Δεν θα αλληλεπιδράσετε απευθείας με αυτά, αλλά η παρουσία τους εξηγεί γιατί μια εγκατάσταση που φαίνεται μικρή καταλαμβάνει ωστόσο μερικά megabytes.
Επαλήθευση της εγκατάστασης με μια πραγματική κλήση API
Η εκτέλεση του pip show αποδεικνύει ότι το πακέτο υπάρχει, όχι ότι η διαμόρφωσή σας λειτουργεί. Η πραγματική δοκιμή κάνει ερώτημα στο API. Δημιουργήστε ένα αρχείο με το όνομα test_mistral.py:
import os
from mistralai.client import Mistral
api_key = os.environ.get("MISTRAL_API_KEY")
if not api_key:
print("Error: MISTRAL_API_KEY environment variable is not set.")
else:
client = Mistral(api_key=api_key)
print("Mistral client initialized successfully!")
# Λίστα διαθέσιμων μοντέλων
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Στη συνέχεια εκτελέστε το:
python test_mistral.py
Αυτό το σενάριο ελέγχει δύο πράγματα ταυτόχρονα. Ο έλεγχος στο api_key διαχωρίζει άμεσα μια missing μεταβλητή περιβάλλοντος από ένα γνήσιο πρόβλημα δικτύου· χωρίς αυτόν, θα μπορούσατε να περάσετε δέκα λεπτά υποψιαζόμενοι το τείχος προστασίας σας, όταν απλώς το τερματικό ξανάνοιξε χωρίς τη μεταβλητή. Αν η λίστα μοντέλων εμφανιστεί, το SDK είναι εγκατεστημένο σωστά και το κλειδί σας γίνεται δεκτό από το API.
Κάντε το περιβάλλον αναπαραγώγιμο
Σε ένα ομαδικό έργο, η εγκατάσταση πρέπει να είναι αναπαραγώγιμη. Παγώστε τις εξαρτήσεις σας:
pip freeze > requirements.txt
Οι συνάδελφοί σας μπορούν τότε να ανακατασκευάσουν ακριβώς το ίδιο περιβάλλον με μία μόνο εντολή:
pip install -r requirements.txt
Ο διακομιστής ανάπτυξής σας θα διαβάσει επίσης αυτό το αρχείο. Αποκτήστε τη συνήθεια να το ξαναδημιουργείτε κάθε φορά που προσθέτετε μια βιβλιοθήκη· διαφορετικά, ο κώδικας θα λειτουργεί μόνο στον δικό σας υπολογιστή και πουθενά αλλού.
Τέσσερις συχνές αποτυχίες και πώς να τις διαγνώσετε
Το σφάλμα ModuleNotFoundError: No module named mistralai σχεδόν πάντα σημαίνει ότι το τερματικό δεν χρησιμοποιεί το σωστό εικονικό περιβάλλον. Επαληθεύστε το με which python, το οποίο θα πρέπει να δείχνει στο venv σας, και στη συνέχεια με pip list | grep mistralai.
Το σφάλμα ImportError: cannot import name 'Mistral' from 'mistralai' υποδηλώνει κώδικα γραμμένο για την έκδοση 1 του SDK. Από την έκδοση 2.0, όλες οι εισαγωγές γίνονται μέσω του mistralai.client: γράψτε from mistralai.client import Mistral. Το μάθημα για τις εκδόσεις SDK λεπτομερεί άλλες αλλαγές.
Ένα σφάλμα SSL ή δικτύου συχνά αποκαλύπτει έναν εταιρικό διακομιστή μεσολάβησης (proxy) ανάμεσα σε εσάς και τον έξω κόσμο. Πείτε ρητά στο pip γι’ αυτόν:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Τέλος, αν η εγκατάσταση απορρίπτει την έκδοση Python σας, θυμηθείτε ότι το SDK απαιτεί ελάχιστη Python 3.10 από την έκδοση 2.0. Ενημερώστε την Python, ή εγκαταστήστε το pyenv για να εκτελέσετε πολλαπλές εκδόσεις παράλληλα χωρίς να αγγίξετε τον διερμηνέα του συστήματος.
Βασικά σημεία
- Εγκαταστήστε το SDK με
pip install mistralaiμέσα σε ένα εικονικό περιβάλλον - Η τρέχουσα έκδοση είναι η 3.7.0 (1η Νοεμβρίου 2026)· εισάγετε τον πελάτη μέσω
from mistralai.client import Mistral - Επαληθεύστε την εγκατάστασηαπαριθμώντας τα διαθέσιμα μοντέλα
- Παγώστε τις εξαρτήσεις στο
requirements.txtγια αναπαραγωγιμότητα - Απαιτείται Python 3.10 ή νεότερη