HuggingFace

Maak en configureer je database (Vereist)

Het eerste wat je moet doen is een MongoDB Atlas-database aanmaken en je verbindingsreeks (connection string) ophalen.

Volg de instructies in dit document: MongoDB Atlas

Aan de slag

1. Log in of maak een account aan op Hugging Face

2. Bezoek https://huggingface.co/spaces/LibreChat/template en klik op Duplicate this Space om de LibreChat template naar je profiel te kopiëren.

Let op: Het is normaal dat dit sjabloon een runtime-fout geeft; je zult het moeten configureren met behulp van de volgende handleiding om het functioneel te maken.

3. Geef je Space een naam en vul de Secrets en Variables in

Je kunt hier ook beslissen om het openbaar of privé te maken

Je zult deze waarden moeten invullen:

⬆️ Laat het waardeveld leeg voor elk endpoint dat je wilt uitschakelen.

⚠️ het instellen van de API-sleutels en token op user_provided stelt je in staat om deze veilig op te geven via de webUI

• Gebruik voor CREDS_KEY, CREDS_IV en JWT_SECRET deze tool: Credentials Generator
• Voer het hulpprogramma een tweede keer uit en gebruik de nieuwe JWT_SECRET waarde voor de JWT_REFRESH_SECRET

Deployment

1. Wanneer je klaar bent met het invullen van de secrets en variables, klik je op Duplicate Space onderaan dat venster

2. Het project wordt nu gebouwd, dit zal een paar minuten duren

3. Wanneer gereed, zal Building veranderen in Running

En je zult toegang hebben tot LibreChat!

Update

Om LibreChat bij te werken, selecteer je eenvoudig Factory Reboot in het ⚙️Settings menu

Conclusie

Je hebt nu toegang via de huidige URL. Als je er toegang toe wilt zonder de Hugging Face-overlay, kun je dit URL-sjabloon aanpassen met jouw gegevens:

https://username-projectname.hf.space/

bijv. https://cooluser-librechat.hf.space/

🎉 Gefeliciteerd, je hebt LibreChat succesvol geïmplementeerd op Hugging Face! 🤗

Meilisearch Setup (Optioneel)

Om de zoekfunctionaliteit in LibreChat in te schakelen, moet je een Meilisearch-instantie implementeren en configureren. Dit is hoe:

1. Dupliceer de Meilisearch Space:

Bezoek deze link: https://huggingface.co/spaces/LibreChat/meilisearch en klik op "Duplicate this Space".

2. Configureer de Meilisearch-ruimte:

• Zichtbaarheid: Stel de zichtbaarheid in op "public".

• MEILI_MASTER_KEY: Genereer een veilige master key van 16 tekens. Je kunt een tool zoals https://randomkeygen.com/ gebruiken om een willekeurige sleutel te genereren. Stel deze sleutel in als de waarde voor de MEILI_MASTER_KEY omgevingsvariabele in de Meilisearch-ruimte. Belangrijk: houd deze sleutel veilig!

• MEILI_ENV: Stel de MEILI_ENV omgevingsvariabele in op production.

3. Dupliceer de Space:

Klik op de knop "Duplicate Space".

4. Configureer LibreChat om Meilisearch te gebruiken:

• Bewerk de Dockerfile: Ga naar je LibreChat-omgeving (degene die je hebt gedupliceerd van de hoofd-LibreChat-template). Navigeer naar "Files" -> "Dockerfile" en klik op "Edit".

• Regels uitcommentariëren en aanpassen: Haal de commentaartekens weg bij de volgende regels in de Dockerfile en pas ze aan. Deze regels bevatten ENV SEARCH en ENV MEILI_*. Zorg ervoor dat je <YOUR_MEILISEARCH_SPACE_URL> vervangt door de werkelijke URL van je Meilisearch-implementatie op Hugging Face Spaces. Het zou er ongeveer zo uit moeten zien: https://<your-username>-meilisearch.hf.space/. Update de gebruikersnaam zodat deze overeenkomt met jouw gebruikersnaam!

  ENV SEARCH=true
  ENV MEILI_NO_ANALYTICS=true
  ENV MEILI_HOST=<YOUR_MEILISEARCH_SPACE_URL>

• Wijzigingen doorvoeren: Voer uw wijzigingen door naar de main branch.

5. Voeg de MEILI_MASTER_KEY secret toe aan LibreChat:

• Ga naar de instellingen van je LibreChat-omgeving (de LibreChat-implementatie, niet die van Meilisearch).

• Klik op "New secret".

• Naam: Voer MEILI_MASTER_KEY in.

• Waarde: Voer de zelfde master key in die je hebt gebruikt bij het instellen van de Meilisearch-ruimte.

6. Controleer de installatie:

Nadat LibreChat opnieuw is opgebouwd en is opgestart, zou je een zoekoptie moeten zien linksboven in de LibreChat-interface. Als je deze niet ziet, controleer dan dubbel of je alle stappen correct hebt gevolgd.