HuggingFace

데이터베이스 생성 및 구성 (필수)

가장 먼저 해야 할 일은 MongoDB Atlas 데이터베이스를 생성하고 연결 문자열(connection string)을 얻는 것입니다.

이 문서의 지침을 따르세요: MongoDB Atlas

1. **Hugging Face**에 로그인하거나 계정을 만드세요.

2. **https://huggingface.co/spaces/LibreChat/template**를 방문하여 Duplicate this Space를 클릭하면 LibreChat 템플릿을 귀하의 프로필로 복사할 수 있습니다.

참고: 이 템플릿에서 런타임 오류가 발생하는 것은 정상이며, 기능을 작동시키려면 다음 가이드를 사용하여 구성해야 합니다.

3. Space의 이름을 지정하고 Secrets 및 Variables를 채우세요.

여기에서 공개 또는 비공개로 설정할 수도 있습니다.

다음 값들을 채워야 합니다:

Secrets	Values
MONGO_URI	* 다음 지침을 사용하여 문자열을 가져오세요: https://librechat.ai/docs/configuration/mongodb/mongodb_atlas
OPENAI_API_KEY	`user_provided`
BINGAI_TOKEN	`user_provided`
CHATGPT_TOKEN	`user_provided`
ANTHROPIC_API_KEY	`user_provided`
GOOGLE_KEY	`user_provided`
CREDS_KEY	* 아래 참조
CREDS_IV	* 아래 참조
JWT_SECRET	* 아래 참조
JWT_REFRESH_SECRET	* 아래 참조

⬆️ 비활성화하려는 모든 endpoint의 값 필드를 비워 두세요.

⚠️ API 키와 토큰을 user_provided로 설정하면 webUI에서 안전하게 입력할 수 있습니다.

CREDS_KEY, CREDS_IV 및 JWT_SECRET의 경우 이 도구를 사용하세요: Credentials Generator

도구를 두 번째로 실행하고 새로운 JWT_SECRET 값을 JWT_REFRESH_SECRET에 사용하세요.

Variables	Values
APP_TITLE	LibreChat
ALLOW_REGISTRATION	true

1. secrets와 variables 입력을 마쳤으면, 해당 창 하단의 Duplicate Space를 클릭하세요.

2. 이제 프로젝트가 빌드됩니다. 이 과정은 몇 분 정도 소요됩니다.

3. 준비가 완료되면 Building이 Running으로 변경됩니다.

그러면 LibreChat에 액세스할 수 있게 됩니다!

LibreChat을 업데이트하려면 ⚙️Settings 메뉴에서 Factory Reboot를 선택하기만 하면 됩니다.

이제 현재 URL을 통해 액세스할 수 있습니다. Hugging Face 오버레이 없이 액세스하려면 다음 URL 템플릿을 귀하의 정보로 수정하면 됩니다:

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

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

🎉 축하합니다, Hugging Face에 LibreChat을 성공적으로 배포하셨습니다! 🤗

LibreChat에서 검색 기능을 활성화하려면 Meilisearch 인스턴스를 배포하고 구성해야 합니다. 방법은 다음과 같습니다:

1. Meilisearch Space 복제:

다음 링크를 방문하세요: https://huggingface.co/spaces/LibreChat/meilisearch 그리고 "Duplicate this Space"를 클릭하세요.

2. Meilisearch 공간 구성:

가시성(Visibility): 가시성을 "public"으로 설정하세요.
MEILI_MASTER_KEY: 안전한 16자 마스터 키를 생성하세요. https://randomkeygen.com/과 같은 도구를 사용하여 무작위 키를 생성할 수 있습니다. 이 키를 Meilisearch 공간의 MEILI_MASTER_KEY 환경 변수 값으로 설정하세요. 중요: 이 키를 안전하게 보관하세요!
MEILI_ENV: MEILI_ENV 환경 변수를 production으로 설정하세요.

3. Space 복제:

"Duplicate Space" 버튼을 클릭하세요.

4. LibreChat이 Meilisearch를 사용하도록 구성:

Dockerfile 수정: LibreChat 공간(메인 LibreChat 템플릿에서 복제한 공간)으로 이동합니다. "Files" -> "Dockerfile"로 이동한 다음 "Edit"을 클릭합니다.
줄 주석 해제 및 수정: Dockerfile에서 다음 줄의 주석을 해제하고 수정하세요. 이 줄들에는 ENV SEARCH 및 ENV MEILI_*가 포함되어 있습니다. <YOUR_MEILISEARCH_SPACE_URL>을 Hugging Face Spaces에 배포한 Meilisearch의 실제 URL로 바꾸어야 합니다. https://<your-username>-meilisearch.hf.space/와 같은 형태여야 합니다. 사용자 이름이 본인의 사용자 이름과 일치하도록 업데이트하세요!
```
ENV SEARCH=true
ENV MEILI_NO_ANALYTICS=true
ENV MEILI_HOST=<YOUR_MEILISEARCH_SPACE_URL>
```
변경 사항 커밋: 변경 사항을 main 브랜치에 커밋하세요.

5. LibreChat에 MEILI_MASTER_KEY 시크릿 추가하기:

6. 설정 확인:

LibreChat이 재빌드되고 실행된 후, LibreChat 인터페이스 왼쪽 상단에서 검색 옵션을 확인할 수 있습니다. 만약 보이지 않는다면, 모든 단계를 올바르게 따랐는지 다시 한번 확인해 주세요.