त्वरित शुरुआत
आवश्यकताएँ
| घटक | न्यूनतम | अनुशंसित |
|---|---|---|
| Node.js | 22.22+ | नवीनतम LTS |
| RAM | 8 GB | 16 GB+ |
| डिस्क | 5 GB | मॉडल के लिए 20 GB+ |
| GPU | वैकल्पिक | तेज़ स्थानीय अनुमान के लिए 8 GB+ VRAM |
| Docker | वैकल्पिक | Work कार्यों के लिए आवश्यक |
Libre WebUI केवल CPU वाले Ollama के साथ काम करता है, लेकिन CPU पर छोटे मॉडल अधिक उपयुक्त हैं। क्लाउड प्रदाता प्लगइन के लिए केवल संबंधित API कुंजी चाहिए।
चैट, दस्तावेज़, आर्टिफ़ैक्ट और प्रदाता-समर्थित सुविधाओं को Docker की आवश्यकता नहीं है। Work को इसकी आवश्यकता है: Libre WebUI बैकएंड चलाने वाले कंप्यूटर पर Docker स्थापित होना चाहिए और बैकएंड प्रक्रिया को उसे चलाने की अनुमति होनी चाहिए। npx libre-webui कमांड Docker स्थापित नहीं करती। Docker उपलब्ध न होने पर Libre WebUI का शेष भाग चलता रहता है और Work Runtime unavailable बताता है; मॉडल कमांड को वैकल्पिक उपाय के रूप में कभी सीधे होस्ट पर नहीं चलाया जाता।
Libre WebUI शुरू करना
npx libre-webui@latest
http://localhost:8080 खोलें। पहला खाता बनाएँ; वही व्यवस्थापक बनेगा। बाद का सार्वजनिक पंजीकरण तब तक बंद रहता है जब तक आप स्पष्ट रूप से ENABLE_SIGNUP=true न सेट करें।
पैकेज किया हुआ लॉन्चर स्थायी स्थिति ~/.libre-webui में रखता है। दूसरी जगह चुनने के लिए निरपेक्ष DATA_DIR सेट करें; सापेक्ष मान उस निर्देशिका से हल होते हैं जहाँ आप npx चलाते हैं।
Ollama स्थापित करना
Ollama स्थापित करें, फिर एक छोटा सामान्य मॉडल डाउनलोड करें:
ollama pull gemma4:12b
अन्य अच्छे विकल्प gemma4:26b (MoE), gemma4:31b (dense) और qwen3.8:27b हैं। स्थापित मॉडल देखने, वर्तमान Ollama Library खोजने और ऐप छोड़े बिना मॉडल डाउनलोड करने के लिए Libre WebUI में Model Manager का उपयोग करें।
अर्थ-आधारित दस्तावेज़ खोज के लिए एम्बेडिंग मॉडल भी स्थापित करें:
ollama pull nomic-embed-text
क्लाउड प्रदाता जोड़ना
क्लाउड प्रदाता वैकल्पिक हैं। प्रत्येक उपयोगकर्ता की कुंजी Settings → API keys में या पूरे सर्वर की कुंजी backend/.env में जोड़ें (इसके बाद बैकएंड पुनः शुरू करें), फिर Settings में प्रदाता सक्रिय करें:
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 प्रत्येक कार्य को स्थायी बातचीत और कंटेनर-आधारित अलग फ़ाइल प्रणाली देता है। यह प्रमाणित व्यवस्थापकों के लिए उपलब्ध है।
- Libre WebUI बैकएंड वाले कंप्यूटर पर Docker स्थापित करके शुरू करें।
- साइडबार शीर्षक के Work बटन, टैब पट्टी के
+मेनू, Home पृष्ठ याCmd/Ctrl + Shift + Uसे कार्य शुरू करें। - उपकरण कॉल समर्थित करने वाला मॉडल चुनें।
- बताएँ कि क्या बनाना या बदलना है, फिर Run चुनें।
- कार्यक्षेत्र पैनल की Files, Activity, Git, Terminal और Preview टैब में परिणाम देखें।
कार्य साइडबार में रहता है, इसलिए आप उसी बातचीत और फ़ाइलों पर बाद में लौट सकते हैं। रन या पूर्वावलोकन रोकने पर कार्यक्षेत्र सुरक्षित रहता है। कार्य हटाने पर उसका कार्यक्षेत्र स्थायी रूप से मिट जाता है।
Work स्थापित Ollama मॉडल, Ollama Cloud मॉडल या कॉन्फ़िगर किया हुआ चैट/पूर्णता प्रदाता प्लगइन उपयोग कर सकता है। दूरस्थ प्रदाता चुनने पर Libre WebUI रन से पहले बताता है: प्रदाता को बातचीत, उपकरण परिभाषाएँ और मॉडल द्वारा माँगे गए उपकरण परिणाम मिलेंगे। स्वचालित रन कई सशुल्क प्रदाता कॉल कर सकता है।
रनटाइम, स्थायित्व, नेटवर्क, पूर्वावलोकन और सुरक्षा सीमाओं के लिए Work: अलग-थलग कार्यक्षेत्र देखें।
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
ब्राउज़र में पहला व्यवस्थापक बनाएँ। पंजीकरण फ़्लैग या पुनः आरंभ आवश्यक नहीं है; बाद का सार्वजनिक पंजीकरण डिफ़ॉल्ट रूप से बंद है।
यदि Ollama पहले से होस्ट या किसी दूसरे कंप्यूटर पर चल रहा है:
docker compose -f docker-compose.external-ollama.yml up -d
NVIDIA GPU त्वरण के लिए रिपॉज़िटरी की GPU Compose फ़ाइल उपयोग करें।
रिपॉज़िटरी की Compose फ़ाइलें होस्ट का Docker सॉकेट माउंट करती हैं, इसलिए Docker स्थापित होने पर Work उपलब्ध है। इससे ऐप को होस्ट पर root के बराबर नियंत्रण मिलता है; पहले Work: अलग-थलग कार्यक्षेत्र पढ़ें। Linux में .env का DOCKER_GID सॉकेट के स्वामी समूह पर सेट करें। Work नहीं चाहिए तो माउंट हटाएँ।
पैकेज किया Ollama भी केवल आंतरिक है। किसी अन्य होस्ट प्रक्रिया को API चाहिए तभी -f docker-compose.ollama-host.yml जोड़ें; ओवरराइड डिफ़ॉल्ट रूप से लूपबैक से जुड़ता है।
ऐप में रास्ता खोजना
Home टैब में तीन भाग हैं: Start (नया चैट, गुप्त चैट, नया Work कार्य), Continue (हाल की बातचीत और कार्य) और Explore (Notes, Calendar, Automations, Models, Personas, Imagine)। यही स्थान साइडबार नेविगेशन पंक्ति और कमांड पैलेट (Cmd/Ctrl + K) में मिलते हैं, जो चैट, Work कार्य, ऐप क्रियाएँ, संदेश, नोट और दस्तावेज़ खोजता है।
- कैलेंडर — हर उपयोगकर्ता का दोहराए जाने वाले कार्यक्रमों वाला कैलेंडर।
- स्वचालन — चैट सत्र के रूप में दिए जाने वाले निर्धारित AI रन।
कुंजीपटल शॉर्टकट
| शॉर्टकट | क्रिया |
|---|---|
Cmd/Ctrl + K | कमांड पैलेट (टाइप करते समय भी) |
Cmd/Ctrl + Shift + O | नया चैट |
Cmd/Ctrl + Shift + U | नया Work कार्य |
Cmd/Ctrl + B | साइडबार खोलें/बंद करें |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | थीम बदलें |
? | Settings को Shortcuts टैब पर खोलें |
Esc | सेटिंग विंडो बंद करें |
Enter | संदेश भेजें |
Shift + Enter | नई पंक्ति |