HuggingFace

Utwórz i skonfiguruj bazę danych (Wymagane)

Pierwszą rzeczą, którą musisz zrobić, jest utworzenie bazy danych MongoDB Atlas i uzyskanie ciągu połączenia (connection string).

Postępuj zgodnie z instrukcjami zawartymi w tym dokumencie: MongoDB Atlas

Wprowadzenie

1. Zaloguj się lub utwórz konto na Hugging Face

2. Odwiedź https://huggingface.co/spaces/LibreChat/template i kliknij Duplicate this Space, aby skopiować szablon LibreChat do swojego profilu.

Uwaga: To normalne, że ten szablon wykazuje błąd wykonania; aby zaczął działać, należy go skonfigurować zgodnie z poniższym przewodnikiem.

3. Nazwij swoją przestrzeń (Space) i wypełnij Secrets oraz Variables

Możesz tutaj również zdecydować, czy uczynić go publicznym, czy prywatnym

Będziesz musiał wypełnić te wartości:

⬆️ Pozostaw pole wartości puste dla wszystkich endpoint, które chcesz wyłączyć.

⚠️ ustawienie kluczy API oraz tokena na user_provided pozwala na bezpieczne podanie ich z poziomu webUI

• Dla CREDS_KEY, CREDS_IV oraz JWT_SECRET użyj tego narzędzia: Generator poświadczeń
• Uruchom narzędzie po raz drugi i użyj nowej wartości JWT_SECRET dla JWT_REFRESH_SECRET

Wdrożenie

1. Gdy skończysz wypełniać secrets i variables, kliknij Duplicate Space na dole tego okna

2. Projekt zostanie teraz zbudowany, zajmie to kilka minut

3. Gdy wszystko będzie gotowe, status Building zmieni się na Running

I będziesz mieć dostęp do LibreChat!

Aktualizacja

Aby zaktualizować LibreChat, po prostu wybierz Factory Reboot z menu ⚙️Settings

Podsumowanie

Możesz teraz uzyskać do niego dostęp z bieżącego adresu URL. Jeśli chcesz uzyskać do niego dostęp bez nakładki Hugging Face, możesz zmodyfikować ten szablon adresu URL za pomocą swoich informacji:

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

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

🎉 Gratulacje, pomyślnie wdrożyłeś LibreChat na Hugging Face! 🤗

Konfiguracja Meilisearch (opcjonalna)

Aby włączyć funkcję wyszukiwania w LibreChat, musisz wdrożyć i skonfigurować instancję Meilisearch. Oto jak to zrobić:

1. Zduplikuj przestrzeń Meilisearch:

Odwiedź ten link: https://huggingface.co/spaces/LibreChat/meilisearch i kliknij „Duplicate this Space”.

2. Skonfiguruj przestrzeń Meilisearch:

• Widoczność: Ustaw widoczność na "public".

• MEILI_MASTER_KEY: Wygeneruj bezpieczny 16-znakowy klucz główny. Możesz użyć narzędzia takiego jak https://randomkeygen.com/, aby wygenerować losowy klucz. Ustaw ten klucz jako wartość zmiennej środowiskowej MEILI_MASTER_KEY w przestrzeni Meilisearch. Ważne: Przechowuj ten klucz w bezpiecznym miejscu!

• MEILI_ENV: Ustaw zmienną środowiskową MEILI_ENV na production.

3. Zduplikuj Space:

Kliknij przycisk "Duplicate Space".

4. Skonfiguruj LibreChat, aby używał Meilisearch:

• Edytuj plik Dockerfile: Przejdź do swojej przestrzeni LibreChat (tej, którą zduplikowałeś z głównego szablonu LibreChat). Przejdź do "Files" -> "Dockerfile" i kliknij "Edit".

• Odkomentuj i zmodyfikuj linie: Odkomentuj/edytuj poniższe linie w pliku Dockerfile. Linie te będą zawierać ENV SEARCH oraz ENV MEILI_*. Upewnij się, że zastąpisz <YOUR_MEILISEARCH_SPACE_URL> rzeczywistym adresem URL swojego wdrożenia Meilisearch na Hugging Face Spaces. Powinien on wyglądać mniej więcej tak: https://<your-username>-meilisearch.hf.space/. Zaktualizuj nazwę użytkownika, aby pasowała do Twojej!

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

• Zatwierdź zmiany: Zatwierdź swoje zmiany w gałęzi main.

5. Dodaj klucz tajny MEILI_MASTER_KEY do LibreChat:

• Przejdź do ustawień swojego obszaru LibreChat (wdrożenia LibreChat, a nie Meilisearch).

• Kliknij "New secret".

• Nazwa: Wprowadź MEILI_MASTER_KEY.

• Wartość: Wprowadź ten sam klucz główny (master key), którego użyłeś podczas konfigurowania przestrzeni Meilisearch.

6. Weryfikacja konfiguracji:

Po przebudowaniu i uruchomieniu LibreChat, w lewym górnym rogu interfejsu LibreChat powinna pojawić się opcja wyszukiwania. Jeśli jej nie widzisz, sprawdź dokładnie, czy wykonałeś wszystkie kroki poprawnie.