Γρήγορη εκκίνηση
Απαιτήσεις
| Απαίτηση | Ελάχιστο | Συνιστώμενο |
|---|---|---|
| Node.js | 22.22+ | Τελευταίο LTS |
| RAM | 8 GB | 16 GB+ |
| Δίσκος | 5 GB | 20 GB+ για μοντέλα |
| GPU | Προαιρετική | 8 GB+ VRAM για γρήγορο τοπικό inference |
| Docker | Προαιρετικό | Απαιτείται για Work |
Το Libre WebUI λειτουργεί με Ollama μόνο σε CPU, αλλά μικρότερα μοντέλα ταιριάζουν καλύτερα. Για cloud plugins χρειάζεται μόνο το σχετικό API key.
Chat, έγγραφα, artifacts και λειτουργίες παρόχων δεν απαιτούν Docker. Το Work απαιτεί: Docker στο μηχάνημα backend και άδεια κλήσης από τη διεργασία. Το npx libre-webui δεν εγκαθιστά Docker. Χωρίς Docker, το υπόλοιπο λειτουργεί και το Work αναφέρει Runtime unavailable· εντολές μοντέλου δεν εκτελούνται στον host ως fallback.
Εκκίνηση Libre WebUI
npx libre-webui@latest
Ανοίξτε http://localhost:8080. Ο πρώτος λογαριασμός γίνεται διαχειριστής. Μετέπειτα δημόσια εγγραφή μένει κλειστή εκτός αν ορίσετε ENABLE_SIGNUP=true.
Ο packaged launcher κρατά μόνιμη κατάσταση στο ~/.libre-webui. Για άλλη θέση ορίστε απόλυτο DATA_DIR· σχετικές τιμές επιλύονται από τον φάκελο όπου τρέχει npx.
Εγκατάσταση Ollama
Εγκαταστήστε Ollama και κατεβάστε μικρό γενικό μοντέλο:
ollama pull gemma4:12b
Άλλες καλές επιλογές: gemma4:26b (MoE), gemma4:31b (dense), qwen3.8:27b. Το Model Manager εμφανίζει εγκατεστημένα μοντέλα, ψάχνει την Ollama Library και κατεβάζει μέσα στην εφαρμογή.
Για σημασιολογική αναζήτηση εγκαταστήστε επίσης embedding model:
ollama pull nomic-embed-text
Προσθήκη cloud παρόχων
Οι cloud πάροχοι είναι προαιρετικοί. Προσθέστε keys ανά χρήστη στο Settings → API keys ή σε όλο τον server στο backend/.env (επανεκκινήστε backend), μετά ενεργοποιήστε τον πάροχο:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Η εφαρμογή ανανεώνει λίστες μοντέλων όταν υποστηρίζεται· δεν χρειάζεται ανοιχτή τεκμηρίωση.
Πρώτη εργασία Work
Το Work δίνει σε κάθε εργασία μόνιμη συνομιλία και ξεχωριστό filesystem σε container. Είναι διαθέσιμο σε πιστοποιημένους διαχειριστές.
- Εγκαταστήστε και εκκινήστε Docker στον backend host.
- Ξεκινήστε από Work στο sidebar, το
+στις καρτέλες, Home ήCmd/Ctrl + Shift + U. - Επιλέξτε μοντέλο που υποστηρίζει tool calling.
- Περιγράψτε τι θέλετε και επιλέξτε Run.
- Ακολουθήστε το αποτέλεσμα στα Files, Activity, Git, Terminal, Preview.
Η εργασία μένει στο sidebar. Διακοπή run ή preview διατηρεί τον χώρο· διαγραφή τον αφαιρεί μόνιμα.
Το Work χρησιμοποιεί εγκατεστημένο Ollama, Ollama Cloud ή ρυθμισμένο chat/completion plugin. Για απομακρυσμένο πάροχο εμφανίζεται προειδοποίηση ότι λαμβάνει συνομιλία, ορισμούς εργαλείων και ζητημένα αποτελέσματα. Αυτόνομη εκτέλεση μπορεί να κάνει πολλά χρεώσιμα calls.
Δείτε Work: απομονωμένοι χώροι για runtime, αποθήκευση, δίκτυο, preview και ασφάλεια.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Δημιουργήστε τον πρώτο διαχειριστή στον browser. Δεν χρειάζεται flag ή restart· επόμενες δημόσιες εγγραφές κλείνουν από προεπιλογή.
Αν Ollama τρέχει ήδη στον host ή άλλο μηχάνημα:
docker compose -f docker-compose.external-ollama.yml up -d
Για NVIDIA GPU χρησιμοποιήστε το GPU Compose file του repository.
Τα Compose files συνδέουν το Docker socket για Work και δίνουν στην εφαρμογή έλεγχο host ισοδύναμο με root. Διαβάστε Work: απομονωμένοι χώροι, σε Linux ορίστε DOCKER_GID στο .env και αφαιρέστε το mount αν δεν θέλετε Work.
Το ενσωματωμένο Ollama είναι μόνο εσωτερικό. Προσθέστε -f docker-compose.ollama-host.yml μόνο αν άλλο process host χρειάζεται API· το override δένει loopback.
Περιήγηση
Η καρτέλα Home έχει Start, Continue, Explore. Οι ίδιοι προορισμοί βρίσκονται στο sidebar και command palette (Cmd/Ctrl + K), με fuzzy αναζήτηση σε chats, Work, actions και full text σε μηνύματα, σημειώσεις και έγγραφα.
- Ημερολόγιο — ανά χρήστη με επαναλαμβανόμενα συμβάντα.
- Αυτοματισμοί — προγραμματισμένες εκτελέσεις AI ως chats.
Συντομεύσεις πληκτρολογίου
| Συντόμευση | Ενέργεια |
|---|---|
Cmd/Ctrl + K | Command palette |
Cmd/Ctrl + Shift + O | Νέο chat |
Cmd/Ctrl + Shift + U | Νέα εργασία Work |
Cmd/Ctrl + B | Εναλλαγή sidebar |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Εναλλαγή θέματος |
? | Settings στην καρτέλα Shortcuts |
Esc | Κλείσιμο διαλόγου |
Enter | Αποστολή μηνύματος |
Shift + Enter | Νέα γραμμή |