# Οδηγός Αντιμετώπισης Προβλημάτων για το AI-For-Beginners

Αυτός ο οδηγός σας βοηθά να επιλύσετε κοινά προβλήματα που προκύπτουν κατά τη χρήση ή τη συνεισφορά στο αποθετήριο [AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners). Κάθε πρόβλημα περιλαμβάνει υπόβαθρο, συμπτώματα, εξηγήσεις και βήμα-βήμα λύσεις.

---

## Πίνακας Περιεχομένων

- [Γενικά Προβλήματα](../..)
- [Προβλήματα Εγκατάστασης](../..)
- [Προβλήματα Ρύθμισης](../..)
- [Εκτέλεση Σημειωματάριων](../..)
- [Προβλήματα Απόδοσης](../..)
- [Προβλήματα Ιστοσελίδας Βιβλίου](../..)
- [Προβλήματα Συνεισφοράς](../..)
- [Συχνές Ερωτήσεις](../..)
- [Λήψη Βοήθειας](../..)

---

## Γενικά Προβλήματα

### 1. Το Αποθετήριο Δεν Κλωνοποιείται Σωστά

**Υπόβαθρο:** Η κλωνοποίηση σας επιτρέπει να αντιγράψετε το αποθετήριο στον υπολογιστή σας.

**Συμπτώματα:**
- Σφάλμα: `fatal: repository not found`
- Σφάλμα: `Permission denied (publickey)`

**Πιθανές Αιτίες:**
- Λανθασμένο URL αποθετηρίου
- Ανεπαρκή δικαιώματα
- Μη διαμορφωμένα κλειδιά SSH

**Λύσεις:**
1. **Ελέγξτε το URL του αποθετηρίου.**  
   Χρησιμοποιήστε το HTTPS URL:  
   ```
   git clone https://github.com/microsoft/AI-For-Beginners.git
   ```
2. **Μεταβείτε σε HTTPS αν αποτύχει το SSH.**  
   Αν δείτε `Permission denied (publickey)`, χρησιμοποιήστε το HTTPS σύνδεσμο αντί για SSH.
3. **Διαμορφώστε κλειδιά SSH (προαιρετικά).**  
   Αν θέλετε να χρησιμοποιήσετε SSH, ακολουθήστε τον [οδηγό SSH του GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh).

---

## Προβλήματα Εγκατάστασης

### 2. Προβλήματα Περιβάλλοντος Python

**Υπόβαθρο:** Το αποθετήριο βασίζεται στην Python και διάφορες βιβλιοθήκες.

**Συμπτώματα:**
- Σφάλμα: `ModuleNotFoundError: No module named '<package>'`
- Σφάλματα εισαγωγής κατά την εκτέλεση scripts ή σημειωματάριων

**Πιθανές Αιτίες:**
- Μη εγκατεστημένες εξαρτήσεις
- Λανθασμένη έκδοση Python

**Λύσεις:**
1. **Δημιουργήστε ένα εικονικό περιβάλλον.**  
   ```bash
   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   ```
2. **Εγκαταστήστε τις εξαρτήσεις.**  
   ```bash
   pip install -r requirements.txt
   ```
3. **Ελέγξτε την έκδοση Python.**  
   Χρησιμοποιήστε Python 3.7 ή νεότερη.  
   ```bash
   python --version
   ```

### 3. Το Jupyter Δεν Είναι Εγκατεστημένο

**Υπόβαθρο:** Τα σημειωματάρια είναι βασικός πόρος μάθησης.

**Συμπτώματα:**
- Σφάλμα: `jupyter: command not found`
- Τα σημειωματάρια δεν ανοίγουν

**Πιθανές Αιτίες:**
- Το Jupyter δεν είναι εγκατεστημένο

**Λύσεις:**
1. **Εγκαταστήστε το Jupyter Notebook.**  
   ```bash
   pip install notebook
   ```
   ή, αν χρησιμοποιείτε Anaconda:
   ```bash
   conda install notebook
   ```
2. **Ξεκινήστε το Jupyter Notebook.**  
   ```bash
   jupyter notebook
   ```

### 4. Συγκρούσεις Εκδόσεων Εξαρτήσεων

**Υπόβαθρο:** Τα έργα μπορεί να μην λειτουργούν αν οι εκδόσεις των πακέτων δεν ταιριάζουν.

**Συμπτώματα:**
- Σφάλματα ή προειδοποιήσεις για ασυμβίβαστες εκδόσεις

**Πιθανές Αιτίες:**
- Παλιά ή συγκρουόμενα πακέτα Python

**Λύσεις:**
1. **Εγκαταστήστε σε καθαρό περιβάλλον.**  
   Διαγράψτε παλιά venv/conda env και δημιουργήστε ένα νέο.
2. **Χρησιμοποιήστε ακριβείς εκδόσεις.**  
   Πάντα εκτελέστε:
   ```bash
   pip install -r requirements.txt
   ```
   Αν αυτό αποτύχει, εγκαταστήστε χειροκίνητα τα ελλείποντα πακέτα όπως περιγράφεται στο README.

---

## Προβλήματα Ρύθμισης

### 5. Μη Ρυθμισμένες Μεταβλητές Περιβάλλοντος

**Υπόβαθρο:** Ορισμένα modules μπορεί να απαιτούν κλειδιά, tokens ή ρυθμίσεις.

**Συμπτώματα:**
- Σφάλμα: `KeyError` ή προειδοποιήσεις για ελλείπουσα ρύθμιση

**Πιθανές Αιτίες:**
- Απαιτούμενες μεταβλητές περιβάλλοντος δεν έχουν ρυθμιστεί

**Λύσεις:**
1. **Ελέγξτε για αρχεία `.env.example` ή παρόμοια.**
2. **Δημιουργήστε ένα αρχείο `.env` και συμπληρώστε τις απαιτούμενες τιμές.**
3. **Επαναφορτώστε το τερματικό ή το IDE μετά τη ρύθμιση των μεταβλητών περιβάλλοντος.**

---

## Εκτέλεση Σημειωματάριων

### 6. Το Σημειωματάριο Δεν Ανοίγει ή Δεν Εκτελείται

**Υπόβαθρο:** Τα σημειωματάρια Jupyter χρειάζονται σωστή ρύθμιση.

**Συμπτώματα:**
- Το σημειωματάριο δεν ανοίγει
- Ο περιηγητής δεν ανοίγει αυτόματα

**Πιθανές Αιτίες:**
- Το Jupyter δεν είναι εγκατεστημένο
- Προβλήματα ρύθμισης περιηγητή

**Λύσεις:**
1. **Εγκαταστήστε το Jupyter (δείτε Προβλήματα Εγκατάστασης παραπάνω).**
2. **Ανοίξτε τα σημειωματάρια χειροκίνητα.**
   - Αντιγράψτε το URL από το τερματικό (π.χ., `http://localhost:8888/?token=...`) και επικολλήστε το στον περιηγητή σας.

### 7. Κατάρρευση ή Πάγωμα Πυρήνα

**Υπόβαθρο:** Οι πυρήνες σημειωματάριων μπορεί να καταρρεύσουν λόγω ορίων πόρων ή σφαλμάτων κώδικα.

**Συμπτώματα:**
- Ο πυρήνας πεθαίνει ή επανεκκινείται επανειλημμένα
- Σφάλματα μνήμης

**Πιθανές Αιτίες:**
- Μεγάλα σύνολα δεδομένων
- Ασυμβίβαστος κώδικας ή πακέτα

**Λύσεις:**
1. **Επανεκκινήστε τον πυρήνα.**  
   Χρησιμοποιήστε το κουμπί "Restart Kernel" στο Jupyter.
2. **Ελέγξτε τη χρήση μνήμης.**  
   Κλείστε αχρησιμοποίητες εφαρμογές.
3. **Εκτελέστε σημειωματάρια σε πλατφόρμες cloud.**  
   Χρησιμοποιήστε [Google Colab](https://colab.research.google.com/) ή [Azure Notebooks](https://notebooks.azure.com/).

---

## Προβλήματα Απόδοσης

### 8. Τα Σημειωματάρια Εκτελούνται Αργά

**Υπόβαθρο:** Ορισμένες εργασίες AI απαιτούν σημαντική μνήμη και CPU.

**Συμπτώματα:**
- Αργή εκτέλεση
- Ο ανεμιστήρας του laptop λειτουργεί έντονα

**Πιθανές Αιτίες:**
- Μεγάλα σύνολα δεδομένων ή μοντέλα
- Περιορισμένοι πόροι συστήματος

**Λύσεις:**
1. **Χρησιμοποιήστε μια πλατφόρμα cloud.**
   - Ανεβάστε το σημειωματάριο στο Colab ή Azure Notebooks.
2. **Μειώστε το μέγεθος του συνόλου δεδομένων.**
   - Χρησιμοποιήστε δείγματα δεδομένων για εξάσκηση.
3. **Κλείστε περιττά προγράμματα.**
   - Ελευθερώστε RAM συστήματος.

---

## Προβλήματα Ιστοσελίδας Βιβλίου

### 9. Το Κεφάλαιο Δεν Φορτώνει

**Υπόβαθρο:** Το online βιβλίο εμφανίζει μαθήματα και κεφάλαια.

**Συμπτώματα:**
- Ένα κεφάλαιο (π.χ., Transformers/BERT) λείπει ή δεν ανοίγει

**Γνωστό Πρόβλημα:**  
- [Πρόβλημα #303](https://github.com/microsoft/AI-For-Beginners/issues/303): “18 Transformers. BERT. δεν μπορεί να ανοίξει στην ιστοσελίδα του βιβλίου.” Προκαλείται από σφάλμα ονόματος αρχείου (`READMEtransformers.md` αντί για `README.md`).

**Λύσεις:**
1. **Ελέγξτε για σφάλματα μετονομασίας αρχείων.**  
   Αν είστε συνεισφέρων, βεβαιωθείτε ότι τα αρχεία κεφαλαίων ονομάζονται `README.md`.
2. **Αναφέρετε ελλείποντα αρχεία.**  
   Ανοίξτε ένα ζήτημα στο GitHub με το όνομα του κεφαλαίου και λεπτομέρειες σφάλματος.

---

## Προβλήματα Συνεισφοράς

### 10. Το PR Δεν Εγκρίνεται ή Οι Δοκιμές Αποτυγχάνουν

**Υπόβαθρο:** Οι συνεισφορές πρέπει να περάσουν δοκιμές και να ακολουθούν οδηγίες.

**Συμπτώματα:**
- Το pull request απορρίπτεται
- Σφάλματα στον CI/CD pipeline

**Πιθανές Αιτίες:**
- Αποτυχημένες δοκιμές
- Μη τήρηση προτύπων κώδικα

**Λύσεις:**
1. **Διαβάστε τις οδηγίες συνεισφοράς.**
   - Ακολουθήστε το [CONTRIBUTING.md](https://github.com/microsoft/AI-For-Beginners/blob/main/CONTRIBUTING.md) του αποθετηρίου.
2. **Εκτελέστε δοκιμές τοπικά πριν την αποστολή.**
3. **Ελέγξτε για κανόνες linting ή απαιτήσεις μορφοποίησης.**

---

## Συχνές Ερωτήσεις

### Πού μπορώ να βρω βοήθεια για συγκεκριμένα modules;
- Κάθε module συνήθως έχει το δικό του README. Ξεκινήστε από εκεί για οδηγίες ρύθμισης και χρήσης.

### Πώς αναφέρω ένα σφάλμα ή ζητώ μια νέα δυνατότητα;
- [Ανοίξτε ένα ζήτημα στο GitHub](https://github.com/microsoft/AI-For-Beginners/issues/new) με σαφή περιγραφή και βήματα αναπαραγωγής.

### Μπορώ να ζητήσω βοήθεια αν το πρόβλημά μου δεν περιλαμβάνεται;
- Ναι! Αναζητήστε υπάρχοντα ζητήματα πρώτα, και αν δεν βρείτε το πρόβλημά σας, δημιουργήστε ένα νέο ζήτημα.

---

## Λήψη Βοήθειας

- **Ελέγξτε Ζητήματα:** [GitHub Issues](https://github.com/microsoft/AI-For-Beginners/issues)
- **Κάντε Ερωτήσεις:** Χρησιμοποιήστε τις Συζητήσεις GitHub ή ανοίξτε ένα ζήτημα.
- **Κοινότητα:** Δείτε τους συνδέσμους του αποθετηρίου για επιλογές συνομιλίας/φόρουμ.

---

_Τελευταία Ενημέρωση: 2025-09-20_

---

**Αποποίηση ευθύνης**:  
Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης AI [Co-op Translator](https://github.com/Azure/co-op-translator). Παρόλο που καταβάλλουμε προσπάθειες για ακρίβεια, παρακαλούμε να έχετε υπόψη ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα θα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή εσφαλμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.