Hoppa till huvudinnehåll

🧪 Guide till utvecklingsgrenen

Grenen dev innehåller nya förbättringar och experimentella funktioner före officiell release.

Experimentell programvara

dev är experimentell och kan innehålla fel, ofullständiga funktioner och inkompatibla ändringar. Använd den bara om du accepterar instabilitet och vill hjälpa Libre WebUI.

🎯 Vad är dev-grenen?​

Nya funktioner testas i dev innan de slås ihop till stabila main: nya funktioner, felrättningar, UI-experiment och prestandaoptimeringar.

🚀 Använd dev-grenen​

Docker (rekommenderas)​

Utvecklings-Compose monterar värdens Docker-socket så Work fungerar. På Linux anger du först DOCKER_GID i .env.

Med extern 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

Enkel 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

Från källkod​

# 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

Testa Work​

Starta Docker, verifiera docker info som backendanvändaren och att uppgiftscontainrar syns i docker ps, kör npm run dev, logga in som administratör och välj en verktygskapabel modell i Work.

npm run test:work

Testerna verifierar Docker-policy, sökvägsgränser, livscykel, kapacitet och verktygsadaptrar för OpenAI, Anthropic och Gemini. Se Work: isolerade arbetsytor.

🔄 Håll dig uppdaterad​

# 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

🐛 Hittat ett fel?​

Före rapportering​

Sök först bland GitHub Issues, prova stabila main och säkerställ att felet kan upprepas.

Rapportera fel​

Rapportera ett fel på GitHub och ta med:

**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]

Hämta commit-hash​

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

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

🏆 Bidrag och erkännande​

Erkännande för bidragsgivare​

Bidragsgivare listas i CONTRIBUTORS.md, nämns i release notes, får medförfattarskap i commits och tack i annonser. Nuvarande gemenskap omfattar rob, jm och fler.

Aktuella bidragsgivare​

Se den fullständiga listan i CONTRIBUTORS.md.

Vill du bidra med kod?​

För kod: forka repositoryt, skapa en gren från dev med git checkout -b feature/amazing-feature dev, gör ändringen och öppna en pull request mot dev. Se bidragsguiden och gemenskapsstadgan.

Pull request-kontroller​

Alla pull requests kör Format & Lint med formatering, frontend-/backend-lint, TypeScript, paket-, regression- och Playwright-test. Misslyckade webbläsartest laddar upp resultat. Electron Dev Build paketerar macOS, Windows och Linux; macOS använder credentialfri ad hoc-signatur och får inte Developer ID/notariseringsuppgifter. Docker Build Test and Push bygger amd64 och arm64 utan registry-inloggning, push eller multiarch-manifest.

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

⚠️ Viktigt​

Datasäkerhet​

  • Säkerhetskopiera före byte till dev.

  • Work-filer ligger i separata libre-work-*-volymer och måste säkerhetskopieras separat.

  • Använd en separat volym:

    # 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öjliga problem​

Inkompatibla ändringar kan kräva konfiguration, funktioner kan vara ofullständiga, prestanda varierar och UI kan ändras.

När du bör använda stabil version​

Byt tillbaka till main om du behöver stabilitet:

# 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

🌟 Delta​

Redo att forma Libre WebUI:s framtid? 🚀

Dina tester, synpunkter och bidrag i dev förbättrar upplevelsen för alla.