Zum Hauptinhalt springen

🧪 Leitfaden zum Entwicklungsbranch

Der Branch dev enthält neue und experimentelle Funktionen vor der offiziellen Veröffentlichung.

Experimentelle Software

dev kann Fehler, unvollständige Funktionen und Breaking Changes enthalten. Nutze ihn nur, wenn du Instabilität akzeptierst.

🎯 Was ist der Dev-Branch?​

Neue Funktionen werden dort vor main getestet: neueste Funktionen, Fehlerkorrekturen, UI-Experimente und Optimierungen.

🚀 Dev-Branch verwenden​

Docker-Einrichtung (empfohlen)​

Compose bindet den Host-Socket ein; Work-Container erscheinen in docker ps. Setze unter Linux DOCKER_GID. Speichere den Wert in .env.

Mit externem 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

Einfaches 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

Aus dem Quellcode​

# 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 testen​

  1. Docker starten und docker info als Backend-Benutzer prüfen.
  2. npm run dev starten.
  3. Als Administrator anmelden.
  4. Work mit einem toolfähigen Ollama-, Cloud- oder Pluginmodell wählen.
npm run test:work

Die Tests prüfen Docker-Policy, Pfade, Lebenszyklus, Kapazität und OpenAI-/Anthropic-/Gemini-Adapter. Siehe Work: isolierte Workspaces.

🔄 Aktuell bleiben​

# 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

🐛 Fehler gefunden? Hilf uns!​

Vor dem Melden​

  1. Bestehende Issues durchsuchen.
  2. Prüfen, ob der Fehler nur in dev auftritt.
  3. Reproduzierbarkeit bestätigen.

Fehler melden​

🐛 Auf GitHub melden

Diese Informationen angeben:

**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-Commit-Hash ermitteln​

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

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

🏆 Beiträge und Anerkennung​

Anerkennung für Beitragende​

  • Eintrag in CONTRIBUTORS.md
  • Erwähnung in Release Notes
  • Co-Autor-Zuordnung
  • Besonderer Dank

Aktuelle Beitragende​

Code beitragen​

  1. Repository forken.
  2. Von dev erstellen: git checkout -b feature/amazing-feature dev.
  3. Änderungen durchführen.
  4. Pull Request gegen dev senden.

Siehe Beitragsrichtlinien und Community-Charta.

Pull-Request-Prüfungen​

Format & Lint prüft auch gestapelte PRs: Format, Frontend/Backend-Lint, TypeScript, Pakete, Regression und Playwright; Fehler laden Ergebnisse hoch. Electron Dev Build paketiert drei Betriebssysteme; macOS nutzt Ad-hoc-Signatur ohne Developer-ID-/Notarisierungsdaten. Docker Build Test and Push baut amd64/arm64, meldet sich bei PRs aber nicht an, pusht nichts und veröffentlicht kein Multiarch-Manifest.

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

⚠️ Wichtige Hinweise​

Datensicherheit​

  • Vor Wechsel sichern.
  • libre-work-*-Volumes getrennt von SQLite sichern.
  • Eigenes Dev-Volume verwenden: 
    # 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

Mögliche Probleme​

  • Breaking Changes, unvollständige Funktionen, schwankende Leistung und unerwartete UI.

Wann Stable verwenden?​

Bei wichtigen Arbeiten, zu vielen Fehlern oder gewünschter Stabilität zu main zurückkehren:

# 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

🌟 Community beitreten​

Bereit, Libre WebUI mitzugestalten? 🚀

Tests, Feedback und Beiträge verbessern die Erfahrung für alle.