मुख्य कंटेंट तक स्किप करें

🧪 डेवलपमेंट शाखा मार्गदर्शिका

आधिकारिक रिलीज़ से पहले नई सुविधाएँ आज़माना चाहते हैं? dev शाखा में अत्याधुनिक सुधार और प्रयोगात्मक सुविधाएँ हैं जो बाद में मुख्य रिलीज़ में आएँगी।

प्रयोगात्मक सॉफ़्टवेयर

dev शाखा प्रयोगात्मक है और उसमें त्रुटियाँ, अधूरी सुविधाएँ या असंगत परिवर्तन हो सकते हैं। संभावित अस्थिरता स्वीकार हो और Libre WebUI सुधारना चाहते हों तभी उपयोग करें।

🎯 Dev शाखा क्या है?​

डेवलपमेंट शाखा (dev) नई सुविधाओं को स्थिर main में मिलाने से पहले जाँचने का स्थान है। इसमें हैं:

  • स्थिर रिलीज़ में अभी न आई नई सुविधाएँ
  • जाँचे जा रहे त्रुटि सुधार
  • इंटरफ़ेस और व्यवहार के प्रयोगात्मक सुधार
  • विकसित हो रहे प्रदर्शन सुधार

🚀 Dev शाखा उपयोग करना​

Docker सेटअप (अनुशंसित)​

डेवलपमेंट Compose फ़ाइलें होस्ट Docker सॉकेट माउंट करती हैं, इसलिए Docker उपलब्ध हो तो Work डिफ़ॉल्ट रूप से चलता है। कार्य कंटेनर होस्ट सेवा में चलते और docker ps में दिखते हैं। Linux में पहले .env में DOCKER_GID सेट करें।

बाहरी Ollama के साथ:

# Clone the repository
git clone https://github.com/libre-webui/libre-webui.git
cd libre-webui

# Switch to dev branch
git checkout dev

# Start the dev image with external Ollama
docker compose -f docker-compose.dev.external-ollama.yml up -d

सरल Docker:

# Use the dev branch image
docker run -d -p 3000:3001 -v libre-webui:/app/backend/data --name libre-webui-dev --restart always ghcr.io/libre-webui/libre-webui:dev

स्रोत से​

# Clone and switch to dev branch
git clone https://github.com/libre-webui/libre-webui.git
cd libre-webui
git checkout dev

# Install dependencies
npm install

# Start development server
npm run dev

Work जाँचना​

  1. Docker शुरू करें और पुष्टि करें कि docker info उसी उपयोगकर्ता से चलता है जो बैकएंड चलाता है।
  2. Libre WebUI को स्रोत से npm run dev द्वारा शुरू करें।
  3. व्यवस्थापक के रूप में प्रवेश करें।
  4. Work चुनकर उपकरण-समर्थित Ollama, Ollama Cloud या प्लगइन मॉडल उपयोग करें।

केंद्रित प्रदाता और कंटेनर नीति परीक्षण चलाएँ:

npm run test:work

परीक्षण बनी Docker नीति, पथ सीमा, जीवनचक्र, क्षमता और OpenAI-संगत, Anthropic तथा Gemini उपकरण एडाप्टर जाँचते हैं। पूरी सीमा Work: अलग-थलग कार्यक्षेत्र में है।

🔄 अद्यतन रहना​

Dev शाखा अक्सर बदलती है। नवीनतम परिवर्तन पाने के लिए:

# Update your local dev branch
git pull origin dev

# Refresh the dev Compose stack
docker compose -f docker-compose.dev.external-ollama.yml pull
docker compose -f docker-compose.dev.external-ollama.yml up -d

# Or restart simple Docker
docker pull ghcr.io/libre-webui/libre-webui:dev
docker stop libre-webui-dev && docker rm libre-webui-dev
docker run -d -p 3000:3001 -v libre-webui:/app/backend/data --name libre-webui-dev --restart always ghcr.io/libre-webui/libre-webui:dev

🐛 त्रुटि मिली? सुधार में सहायता करें!​

आपकी रिपोर्ट महत्वपूर्ण है। प्रभावी रिपोर्ट के लिए:

रिपोर्ट से पहले​

  1. मौजूदा मुद्दे जाँचें: दोहराव से बचने के लिए GitHub Issues खोजें
  2. स्थिर संस्करण आज़माएँ: पुष्टि करें कि त्रुटि केवल dev में है
  3. दोबारा उत्पन्न करें: क्या त्रुटि फिर कर सकते हैं?

त्रुटि रिपोर्ट करना​

🐛 GitHub पर त्रुटि बताएँ

यह जानकारी दें:

**Environment:**

- Branch: dev
- Version: [git commit hash or date]
- OS: [Windows/macOS/Linux]
- Browser: [Chrome/Firefox/Safari version]
- Setup: [Docker/Source/etc.]
- Docker: [version and whether `docker info` succeeds, for Work issues]
- Work model/provider: [exact route, when applicable]

**Bug Description:**
Clear description of what went wrong

**Steps to Reproduce:**

1. Go to...
2. Click on...
3. See error...

**Expected Behavior:**
What should have happened

**Actual Behavior:**
What actually happened

**Screenshots/Logs:**
[If applicable, add screenshots or error logs]

**Work Activity:**
[Relevant tool call/result or preview output, with secrets removed]

Git कमिट हैश पाना​

# Find your current dev branch commit
git rev-parse HEAD

# Or get a short version
git rev-parse --short HEAD

🏆 योगदान और सम्मान​

Dev शाखा उपयोग करके आप परीक्षण समुदाय का भाग बनते हैं। योगदान को कई तरह मान्यता मिलती है:

योगदानकर्ताओं का सम्मान​

  • CONTRIBUTORS.md में सूची
  • महत्वपूर्ण योगदान पर रिलीज़ नोट में उल्लेख
  • कमिट संदेश में सह-लेखक श्रेय
  • परियोजना घोषणा में विशेष धन्यवाद

वर्तमान योगदानकर्ता​

समुदाय में, अन्य लोगों के साथ:

  • rob - परियोजना अनुरक्षक
  • jm - नेटवर्क पहुँच सुधार
  • और भी! पूरी सूची देखें

कोड योगदान करना है?​

  1. रिपॉज़िटरी फ़ोर्क करें
  2. dev से फ़ीचर शाखा बनाएँ: git checkout -b feature/amazing-feature dev
  3. परिवर्तन करें
  4. dev में Pull Request भेजें

विस्तृत निर्देश के लिए योगदान मार्गदर्शिका, नैतिकता और शासन के लिए Community Charter देखें।

Pull Request जाँच​

मध्यवर्ती शाखा वाले अनुरोध सहित हर Pull Request Format & Lint कार्यप्रवाह चलाता है। स्वतंत्र काम फ़ॉर्मैट, फ्रंटएंड/बैकएंड जाँच, TypeScript प्रकार, पैकेज/प्रतिगमन परीक्षण और Playwright ब्राउज़र समूह जाँचते हैं। विफल ब्राउज़र रन परिणाम अपलोड करते हैं।

Electron Dev Build macOS, Windows और Linux आर्टिफ़ैक्ट भी पैक करता है। macOS Pull Request बिल्ड बिना क्रेडेंशियल वाला विशेष हस्ताक्षर रखते हैं, ताकि ऐप अपलोड से पहले जाँचा जा सके। कार्यप्रवाह को Developer ID या नोटरी क्रेडेंशियल नहीं मिलते।

Docker Build Test and Push हर अनुरोध के लिए amd64/arm64 इमेज बनाता है। बिल्ड रजिस्ट्री में प्रवेश नहीं करते, digest नहीं भेजते और बहु-वास्तुकला मैनिफ़ेस्ट प्रकाशित नहीं करते।

Pull Request खोलने से पहले यही जाँच स्थानीय रूप से चलाएँ:

npm run format:check
npm run lint
npm run test:package
npm run test:e2e

⚠️ महत्वपूर्ण बातें​

डेटा सुरक्षा​

  • Dev शाखा पर जाने से पहले डेटा का बैकअप लें
  • Work फ़ाइलें अलग libre-work-* Docker वॉल्यूम में हैं। विनाशकारी जीवनचक्र जाँच से पहले SQLite से अलग बैकअप लें।
  • Dev परीक्षण के लिए अलग Docker वॉल्यूम उपयोग करें: 
    # Use different volume name for dev
    docker run -d -p 3000:3001 -v libre-webui-dev:/app/backend/data --name libre-webui-dev ghcr.io/libre-webui/libre-webui:dev

संभावित समस्याएँ​

  • असंगत परिवर्तन कॉन्फ़िगरेशन अद्यतन माँग सकते हैं
  • सुविधाएँ अधूरी हो सकती हैं या बिना सूचना बदल सकती हैं
  • अनुकूलन जाँच के दौरान प्रदर्शन बदल सकता है
  • इंटरफ़ेस तत्व अलग दिख या व्यवहार कर सकते हैं

स्थिर संस्करण कब उपयोग करें​

इन स्थितियों में स्थिर main पर लौटें:

  • महत्वपूर्ण काम के लिए विश्वसनीयता चाहिए
  • बहुत त्रुटियाँ मिल रही हों
  • जाँचा हुआ स्थिर अनुभव चाहिए
# Switch back to stable
git checkout main
docker compose -f docker-compose.external-ollama.yml pull
docker compose -f docker-compose.external-ollama.yml up -d

🌟 समुदाय में शामिल हों​

Libre WebUI का भविष्य बनाने में सहायता के लिए तैयार हैं? 🚀

Dev शाखा पर परीक्षण, प्रतिक्रिया और योगदान सभी उपयोगकर्ताओं का अनुभव सीधे सुधारते हैं। समुदाय का भाग बनने के लिए धन्यवाद!