HuggingFace

Tạo và Cấu hình Cơ sở dữ liệu của bạn (Bắt buộc)

Điều đầu tiên bạn cần làm là tạo một MongoDB Atlas Database và lấy chuỗi kết nối của bạn.

Làm theo các hướng dẫn trong tài liệu này: MongoDB Atlas

Bắt đầu

1. Đăng nhập hoặc tạo tài khoản trên Hugging Face

2. Truy cập https://huggingface.co/spaces/LibreChat/template và nhấp vào Duplicate this Space để sao chép mẫu LibreChat vào hồ sơ của bạn.

Lưu ý: Việc mẫu này gặp lỗi thời gian chạy là điều bình thường, bạn sẽ cần cấu hình nó theo hướng dẫn sau để làm cho nó hoạt động.

3. Đặt tên cho Space của bạn và điền vào các mục Secrets và Variables

Bạn cũng có thể quyết định tại đây để đặt nó ở chế độ công khai hoặc riêng tư

Bạn sẽ cần điền các giá trị này:

⬆️ Để trống trường giá trị cho bất kỳ endpoint nào mà bạn muốn vô hiệu hóa.

⚠️ việc đặt các API keys và token thành user_provided cho phép bạn cung cấp chúng một cách an toàn từ webUI

• Đối với CREDS_KEY, CREDS_IV và JWT_SECRET, hãy sử dụng công cụ này: Credentials Generator
• Chạy công cụ lần thứ hai và sử dụng giá trị JWT_SECRET mới cho JWT_REFRESH_SECRET

Triển khai

1. Sau khi bạn đã điền xong các mục secrets và variables, hãy nhấp vào Duplicate Space ở cuối cửa sổ đó

2. Dự án hiện sẽ bắt đầu xây dựng, quá trình này sẽ mất vài phút

3. Khi đã sẵn sàng, Building sẽ chuyển thành Running

Và bạn sẽ có thể truy cập LibreChat!

Cập nhật

Để cập nhật LibreChat, chỉ cần chọn Factory Reboot từ menu ⚙️Settings

Kết luận

Bạn hiện có thể truy cập nó từ URL hiện tại. Nếu bạn muốn truy cập mà không có lớp phủ Hugging Face, bạn có thể sửa đổi mẫu URL này với thông tin của mình:

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

ví dụ: https://cooluser-librechat.hf.space/

🎉 Chúc mừng, bạn đã triển khai thành công LibreChat trên Hugging Face! 🤗

Thiết lập Meilisearch (Tùy chọn)

Để kích hoạt tính năng tìm kiếm trong LibreChat, bạn cần triển khai và cấu hình một instance Meilisearch. Dưới đây là cách thực hiện:

1. Sao chép Meilisearch Space:

Truy cập liên kết này: https://huggingface.co/spaces/LibreChat/meilisearch và nhấp vào "Duplicate this Space".

2. Cấu hình Meilisearch Space:

• Visibility: Đặt chế độ hiển thị thành "public".

• MEILI_MASTER_KEY: Tạo một khóa chính bảo mật gồm 16 ký tự. Bạn có thể sử dụng một công cụ như https://randomkeygen.com/ để tạo khóa ngẫu nhiên. Đặt khóa này làm giá trị cho biến môi trường MEILI_MASTER_KEY trong không gian Meilisearch. Quan trọng: Hãy giữ khóa này bảo mật!

• MEILI_ENV: Đặt biến môi trường MEILI_ENV thành production.

3. Sao chép Space:

Nhấp vào nút "Duplicate Space".

4. Cấu hình LibreChat để sử dụng Meilisearch:

• Chỉnh sửa Dockerfile: Truy cập vào không gian LibreChat của bạn (không gian mà bạn đã sao chép từ mẫu LibreChat chính). Điều hướng đến "Files" -> "Dockerfile" và nhấp vào "Edit".

• Bỏ chú thích và sửa đổi các dòng: Bỏ chú thích/chỉnh sửa các dòng sau trong Dockerfile. Các dòng này sẽ chứa ENV SEARCH và ENV MEILI_*. Hãy đảm bảo thay thế <YOUR_MEILISEARCH_SPACE_URL> bằng URL thực tế của bản triển khai Meilisearch của bạn trên Hugging Face Spaces. Nó sẽ có dạng như https://<your-username>-meilisearch.hf.space/. Hãy cập nhật tên người dùng để khớp với tên người dùng của bạn!

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

• Commit Changes: Commit các thay đổi của bạn vào nhánh main.

5. Thêm khóa bí mật MEILI_MASTER_KEY vào LibreChat:

• Đi tới cài đặt không gian LibreChat của bạn (bản triển khai LibreChat, không phải bản Meilisearch).

• Nhấp vào "New secret".

• Tên: Nhập MEILI_MASTER_KEY.

• Giá trị: Nhập cùng một khóa chính (master key) mà bạn đã sử dụng khi thiết lập không gian Meilisearch.

6. Xác minh thiết lập:

Sau khi LibreChat xây dựng lại và bắt đầu chạy, bạn sẽ thấy một tùy chọn tìm kiếm ở phía trên bên trái của giao diện LibreChat. Nếu bạn không thấy nó, hãy kiểm tra kỹ xem bạn đã thực hiện đúng tất cả các bước chưa.