Hızlı Başlangıç
Gereksinimler
| Bileşen | En az | Önerilen |
|---|---|---|
| Node.js | 22.22+ | En yeni LTS sürümü |
| RAM | 8 GB | 16 GB+ |
| Disk | 5 GB | Modeller için 20 GB+ |
| GPU | İsteğe bağlı | Hızlı yerel çıkarım için 8 GB+ VRAM |
| Docker | İsteğe bağlı | Work görevleri için gerekli |
Libre WebUI, yalnızca CPU kullanan Ollama ile çalışır ancak CPU için daha küçük modeller daha uygundur. Bulut sağlayıcı eklentileri için yalnızca ilgili API anahtarı gerekir.
Sohbet, belgeler, yapıtlar ve sağlayıcı destekli özellikler Docker gerektirmez. Work gerektirir: Docker, Libre WebUI arka ucunun çalıştığı bilgisayara kurulmalı ve arka uç işlemi onu çağırabilmelidir. npx libre-webui komutu Docker’ı kurmaz. Docker kullanılamıyorsa Libre WebUI’nin geri kalanı çalışmaya devam eder, Work ise Runtime unavailable bildirir; model komutları yedek yöntem olarak hiçbir zaman doğrudan ana makinede çalıştırılmaz.
Libre WebUI’yi Başlatma
npx libre-webui@latest
http://localhost:8080 adresini açın. İlk hesabı oluşturun; bu hesap yönetici olur. Daha sonraki genel kayıtlar, açıkça ENABLE_SIGNUP=true ayarlanmadıkça kapalı kalır.
Paketli başlatıcı kalıcı durumu ~/.libre-webui içinde tutar. Başka bir konum seçmek için mutlak bir DATA_DIR ayarlayın; göreli değerler npx komutunu çalıştırdığınız dizinden çözümlenir.
Ollama’yı Kurma
Ollama uygulamasını kurun, ardından küçük ve genel amaçlı bir model indirin:
ollama pull gemma4:12b
Diğer güçlü seçenekler gemma4:26b (MoE), gemma4:31b (dense) ve qwen3.8:27b modelleridir. Kurulu modelleri görmek, güncel Ollama Library’de arama yapmak ve uygulamadan çıkmadan model indirmek için Libre WebUI içindeki Model Manager’ı kullanın.
Belgelerde anlamsal arama için ayrıca bir gömme modeli kurun:
ollama pull nomic-embed-text
Bulut Sağlayıcıları Ekleme
Bulut sağlayıcıları isteğe bağlıdır. Anahtarları kullanıcı başına Settings → API keys bölümüne veya sunucu genelinde backend/.env dosyasına ekleyin (sonrasında arka ucu yeniden başlatın), ardından sağlayıcıyı Settings içinden etkinleştirin:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Destekleniyorsa sağlayıcı model listelerini uygulama yeniler. En son model adlarını bulmak için belgeleri açık tutmanız gerekmez.
İlk Work Görevinizi Başlatma
Work, her göreve kalıcı bir konuşma ve kapsayıcı destekli ayrı bir dosya sistemi sağlar. Kimliği doğrulanmış yöneticiler kullanabilir.
- Libre WebUI arka ucunun çalıştığı bilgisayara Docker’ı kurup başlatın.
- Kenar çubuğu başlığındaki Work düğmesinden, sekme çubuğundaki
+menüsünden, Home sayfasından veyaCmd/Ctrl + Shift + Uile görev başlatın. - Araç çağrılarını destekleyen bir model seçin.
- Ne oluşturmak veya değiştirmek istediğinizi açıklayıp Run seçeneğini belirleyin.
- Çalışma alanı bölmesindeki Files, Activity, Git, Terminal ve Preview sekmelerinden sonucu izleyin.
Görev kenar çubuğunda kalır; aynı konuşmaya ve dosyalara daha sonra dönebilirsiniz. Çalıştırmayı veya önizlemeyi durdurmak çalışma alanını korur. Görevi silmek çalışma alanını kalıcı olarak siler.
Work; kurulu bir Ollama modeli, Ollama Cloud modeli veya yapılandırılmış sohbet/tamamlama sağlayıcısı eklentisi kullanabilir. Uzak sağlayıcı seçildiğinde Libre WebUI çalıştırmadan önce bir açıklama gösterir: sağlayıcı konuşmayı, araç tanımlarını ve modelin istediği araç sonuçlarını alır. Otonom bir çalıştırma birden fazla ücretli sağlayıcı çağrısı yapabilir.
Çalışma zamanı, kalıcılık, ağ, önizleme ve güvenlik ayrıntıları için Work: Yalıtılmış Çalışma Alanları sayfasına bakın.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
İlk yöneticiyi tarayıcıda oluşturun. Kayıt bayrağı veya yeniden başlatma gerekmez; sonraki genel kayıtlar varsayılan olarak kapalıdır.
Ollama zaten ana makinede veya başka bir bilgisayarda çalışıyorsa:
docker compose -f docker-compose.external-ollama.yml up -d
NVIDIA GPU hızlandırması için deponun sağladığı GPU Compose dosyasını kullanın.
Depodaki Compose dosyaları ana makinenin Docker yuvasını bağlar; böylece Docker kuruluysa Work kullanılabilir. Bu, uygulamaya ana makinede root yetkisine eşdeğer denetim verir; önce Work: Yalıtılmış Çalışma Alanları sayfasını okuyun. Linux’ta .env içindeki DOCKER_GID değerini yuvanın sahibi olan gruba ayarlayın. Work istenmiyorsa bağlantıyı kaldırın.
Paketli Ollama da yalnızca iç ağdan erişilebilir. Başka bir ana makine işlemi API’ye ihtiyaç duyduğunda -f docker-compose.ollama-host.yml ekleyin; geçersiz kılma varsayılan olarak geri döngüye bağlanır.
Uygulamada Yolunuzu Bulma
Home sekmesinde üç bölüm vardır: Start (yeni sohbet, gizli sohbet, yeni Work görevi), Continue (son konuşmalar ve görevler) ve Explore (Notes, Calendar, Automations, Models, Personas, Imagine). Aynı hedefler kenar çubuğu gezinme satırında ve sohbetleriniz, Work görevleriniz, uygulama eylemleriniz, mesajlarınız, notlarınız ve belgeleriniz içinde bulanık ve tam metin araması yapan komut paletinde (Cmd/Ctrl + K) bulunur.
- Takvim — yinelenen etkinlikleri olan kullanıcı başına takvim.
- Otomasyonlar — sohbet oturumları olarak teslim edilen zamanlanmış AI çalıştırmaları.
Klavye Kısayolları
| Kısayol | Eylem |
|---|---|
Cmd/Ctrl + K | Komut paleti (yazarken çalışır) |
Cmd/Ctrl + Shift + O | Yeni sohbet |
Cmd/Ctrl + Shift + U | Yeni Work görevi |
Cmd/Ctrl + B | Kenar çubuğunu aç/kapat |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Temayı değiştir |
? | Settings’i Shortcuts sekmesinde aç |
Esc | Ayarlar penceresini kapat |
Enter | Mesaj gönder |
Shift + Enter | Yeni satır |