Ξεκίνα τον desktop launcher¶

Οι περισσότεροι χρήστες δεν χρειάζονται τον launcher

Ο Adaptive Learner τρέχει απευθείας στο πρόγραμμα περιήγησης, χωρίς εγκατάσταση, χωρίς Docker, χωρίς launcher: astrapi69.github.io/adaptive-learner. Ο desktop launcher είναι μόνο για σένα, αν θέλεις να φιλοξενήσεις ο ίδιος την εφαρμογή (self-hosting) ή να τρέξεις τοπικά λειτουργίες backend (λειτουργία διακομιστή, τοπικός συγχρονισμός).

Ο desktop launcher είναι ο ευκολότερος τρόπος να τρέξεις τον Adaptive Learner με το δικό του backend στον δικό σου υπολογιστή. Είναι ένα μικρό παράθυρο που κάνει όλα τα υπόλοιπα για σένα: ελέγχει ότι το Docker τρέχει, κατεβάζει και κάνει build το image της εφαρμογής στην πρώτη εκκίνηση (μία φορά, 5-10 λεπτά είναι φυσιολογικά), ξεκινά τα containers, και μετά ανοίγει την εφαρμογή στο πρόγραμμα περιήγησής σου στο http://localhost:8501. Από το ίδιο παράθυρο μπορείς επίσης να σταματήσεις την εφαρμογή, να αλλάξεις τη θύρα ή να τα απεγκαταστήσεις όλα.

Η θύρα είναι εξ ορισμού η 8501 και μπορεί να αλλάξει στο παράθυρο του launcher· αν είναι κατειλημμένη, ο launcher καταφεύγει σε μια ελεύθερη θύρα.

Προϋπόθεση: Docker - ο launcher το ελέγχει μόνος του¶

Ο launcher απαιτεί ένα Docker που τρέχει, γιατί η ίδια η εφαρμογή τρέχει ως ομάδα containers. Δεν χρειάζεται να επαληθεύσεις τίποτα με το χέρι: κατά την εκκίνηση ο ίδιος ο launcher ελέγχει αν το Docker είναι εγκατεστημένο και τρέχει, βρίσκει επίσης ένα Docker που τρέχει κάτω από διαφορετικό Docker context (όπως το Docker Desktop για Linux ή το rootless Docker), και δείχνει ένα σαφές μήνυμα με λύση όταν κάτι λείπει. Αν το Docker δεν είναι καθόλου εγκατεστημένο ακόμη: Εγκατάσταση του Docker Desktop.

Τα μηνύματα του launcher και τι σημαίνουν:

Μήνυμα	Σημασία	Λύση
"Το Docker δεν είναι εγκατεστημένο (το docker δεν είναι στο PATH)."	Η εντολή `docker` δεν βρέθηκε.	Εγκατάσταση του Docker Desktop. Ο launcher δείχνει τον σύνδεσμο εγκατάστασης απευθείας.
"Το Docker είναι εγκατεστημένο αλλά δεν έχει ξεκινήσει." ή "Το Docker δεν τρέχει. Ελέγχθηκε το context '...' (...): ..."	Η υπηρεσία Docker δεν τρέχει αυτή τη στιγμή· η αναλυτική μορφή αναφέρει το context που ελέγχθηκε, το socket και το αρχικό σφάλμα του Docker.	Κάνε κλικ στο κουμπί "Έναρξη Docker" στον launcher (Linux) ή άνοιξε το Docker Desktop (macOS/Windows), και μετά "Δοκίμασε ξανά".
"Το Docker είναι εγκατεστημένο, αλλά δεν έχεις δικαίωμα."	Ο χρήστης σου δεν είναι στην ομάδα `docker` (Linux).	Ο launcher δείχνει την ακριβή εντολή· μετά αποσυνδέσου και συνδέσου ξανά.
"Το Docker δεν αποκρίνεται."	Το Docker πιθανότατα ξεκινά ακόμη (τυπικό αμέσως μετά το άνοιγμα του Docker Desktop).	Περίμενε λίγο, μετά "Δοκίμασε ξανά".
"Το Docker τρέχει μέσω του context '...' - το ενεργό context δεν ήταν προσβάσιμο, ο launcher συνδέθηκε αυτόματα."	Απλώς ενημερωτικό: το Docker έτρεχε κάτω από διαφορετικό context, ο launcher το βρήκε και το χρησιμοποιεί.	Δεν χρειάζεται να κάνεις τίποτα.
"Το Docker Desktop είναι εγκατεστημένο αλλά όχι στο PATH."	Η εφαρμογή Docker Desktop υπάρχει, αλλά το εργαλείο γραμμής εντολών της δεν είναι (ακόμη) προσβάσιμο.	Ξεκίνα το Docker Desktop μέσω του κουμπιού του launcher και περίμενε λίγο.

Ο εντοπισμός context με τα αναλυτικά μηνύματα περιλαμβάνεται στην έκδοση του launcher που ακολουθεί το docker-app-launcher#26· οι παλαιότερες εκδόσεις δείχνουν τα συντομότερα μηνύματα από τον ίδιο πίνακα.

Λήψη¶

Και οι τρεις launchers διατίθενται με κάθε έκδοση στο github.com/astrapi69/adaptive-learner/releases:

Πλατφόρμα	Αρχείο	Άθροισμα ελέγχου
Linux	`adaptive-learner-launcher`	`adaptive-learner-launcher.sha256`
macOS	`adaptive-learner-launcher-macos.zip`	`adaptive-learner-launcher-macos.zip.sha256`
Windows	`adaptive-learner-launcher.exe`	`adaptive-learner-launcher.exe.sha256`

Linux¶

Επαλήθευσε το άθροισμα ελέγχου (και τα δύο αρχεία στον ίδιο φάκελο):
```
sha256sum -c adaptive-learner-launcher.sha256
```
Δώσε δικαίωμα εκτέλεσης. Η λήψη μέσω προγράμματος περιήγησης το αφαιρεί πάντα από το binary, οπότε αυτό το βήμα είναι πάντα απαραίτητο:
```
chmod +x adaptive-learner-launcher
```
Ξεκίνα το, ευκολότερα από το terminal:
```
./adaptive-learner-launcher
```
Το διπλό κλικ στον διαχειριστή αρχείων μπορεί επίσης να λειτουργήσει, ανάλογα με το περιβάλλον σου· το GNOME/Nautilus απαιτεί "Allow executing file as program" στις Ιδιότητες > Δικαιώματα. Η εκκίνηση από το terminal έχει το πλεονέκτημα ότι βλέπεις τα μηνύματα σφάλματος απευθείας.

Γνωστές παγίδες:

"Permission denied": παραλείφθηκε το βήμα 2 (chmod +x).
Σφάλμα GLIBC κατά την εκκίνηση: το binary φτιάχνεται σε Ubuntu 22.04 και χρειάζεται glibc 2.35 ή νεότερη (Ubuntu 22.04+, Debian 12+, Fedora 36+). Σε παλαιότερες διανομές τρέξε την εφαρμογή μέσω install.sh ή απευθείας μέσω Docker Compose.
Η εφαρμογή δεν είναι προσβάσιμη στο πρόγραμμα περιήγησης: η εφαρμογή τρέχει μόνο τοπικά (localhost), οπότε δεν χρειάζεται κανόνας τείχους προστασίας. Αν το πρόγραμμα περιήγησης δεν ανοίξει αυτόματα, άνοιξε το http://localhost:8501 με το χέρι (ή τη θύρα που εμφανίζεται στο παράθυρο του launcher).

macOS¶

Επαλήθευσε το άθροισμα ελέγχου και αποσυμπίεσε το ZIP:

shasum -a 256 -c adaptive-learner-launcher-macos.zip.sha256
unzip adaptive-learner-launcher-macos.zip

Στο πρώτο άνοιγμα, το Gatekeeper μπλοκάρει το binary ως προερχόμενο από "μη αναγνωρισμένο προγραμματιστή". Δύο τρόποι να το παρακάμψεις:
- Δεξί κλικ (ή Ctrl-κλικ) στο binary > Open > επιβεβαίωσε Open στον διάλογο. Το macOS το θυμάται για όλες τις επόμενες εκκινήσεις.
- Ή: Ρυθμίσεις συστήματος > Privacy & Security > κύλισε προς τα κάτω μέχρι την μπλοκαρισμένη εφαρμογή και κάνε κλικ στο Open Anyway.

Windows¶

Επαλήθευσε το άθροισμα ελέγχου (PowerShell, και τα δύο αρχεία στον ίδιο φάκελο):
```
Get-FileHash .\adaptive-learner-launcher.exe -Algorithm SHA256
Get-Content .\adaptive-learner-launcher.exe.sha256
```
Οι δύο τιμές hash πρέπει να ταιριάζουν.
Κάνε διπλό κλικ στο adaptive-learner-launcher.exe. Στην πρώτη εκκίνηση το SmartScreen προειδοποιεί ("Windows protected your PC"): κάνε κλικ στο More info, μετά στο Run anyway.

Αν κάτι πάει στραβά¶

Ο ίδιος ο launcher εμφανίζει έναν διάλογο ειδοποίησης όταν το Docker δεν τρέχει και προσφέρει να ξεκινήσει το Docker Desktop.
Η πρώτη εκκίνηση κατεβάζει και κάνει build το image της εφαρμογής· η λίστα βημάτων στο παράθυρο του launcher (Check Docker / Download / Build / Start / Ready) δείχνει την πρόοδο. Οι επόμενες εκκινήσεις είναι γρήγορες.
Όσο τρέχει η εφαρμογή μπορείς πάντα να τη φτάσεις στο http://localhost:8501 (ή τη θύρα που άλλαξες)· το κουμπί "Άνοιγμα στο πρόγραμμα περιήγησης" στον launcher κάνει το ίδιο.