* 📑 update mkdocs * rename docker override file and add to gitignore * update .env.example - GOOGLE_MODELS * update index.md * doc refactor: split installation and configuration in two sub-folders * doc update: installation guides * doc update: configuration guides * doc: new docker override guide * doc: new beginner's guide for contributions - Thanks @Berry-13 * doc: update documentation_guidelines.md * doc: update testing.md * doc: update deployment guides * doc: update /dev readme * doc: update general_info * doc: add 0 value to doc weight * doc: add index.md to every doc folders * doc: add weight to index.md and move openrouter from free_ai_apis.md to ai_setup.md * doc: update toc so they display properly on the right had side in mkdocs * doc: update pandoranext.md * doc: index logging_system.md * doc: update readme.md * doc: update litellm.md * doc: update ./dev/readme.md * doc:🔖 new presets.md * doc: minor corrections * doc update: user_auth_system.md and presets.md, doc feat: add mermaid support to mkdocs * doc update: add screenshots to presets.md * doc update: add screenshots to - OpenID with AWS Cognito * doc update: BingAI cookie instruction * doc update: discord auth * doc update: facebook auth * doc: corrections to user_auth_system.md * doc update: github auth * doc update: google auth * doc update: auth clean up * doc organization: installation * doc organization: configuration * doc organization: features+plugins & update:plugins screenshots * doc organization: deploymend + general_info & update: tech_stack.md * doc organization: contributions * doc: minor fixes * doc: minor fixes
3.3 KiB
| title | weight |
|---|---|
| 🤗 HuggingFace | -9 |
Hugging Face Deployment 🤗
⚠️ Note - Some features are not supported by HuggingFace:
- Meilisearch
- Social Logins
❗Also:
- You will have to create an online MongoDB Atlas Database to be able to properly deploy
Create and Configure your Database (Required)
The first thing you need is to create a MongoDB Atlas Database and get your connection string.
Follow the instructions in this document: Online MongoDB Database
Getting Started
1. Login or Create an account on Hugging Face
2. Visit [https://huggingface.co/spaces/LibreChat/template]and click on Duplicate this Space to copy the LibreChat template into your profile
3. Name your Space and Fill the Secrets and Variables
You can also decide here to make it public or private
You will need to fill these values:
| Secrets | Values |
|---|---|
| MONGO_URI | * use the string aquired in the previous step |
| OPENAI_API_KEY | user_provided |
| BINGAI_TOKEN | user_provided |
| CHATGPT_TOKEN | user_provided |
| ANTHROPIC_API_KEY | user_provided |
| GOOGLE_KEY | user_provided |
| CREDS_KEY | * see bellow |
| CREDS_IV | * see bellow |
| JWT_SECRET | * see bellow |
| JWT_REFRESH_SECRET | * see bellow |
⬆️ Leave the value field blank for any endpoints that you wish to disable.
⚠️ setting the API keys and token to
user_providedallows you to provide them safely from the webUI
- For
CREDS_KEY,CREDS_IVandJWT_SECRETuse this tool: https://replit.com/@daavila/crypto#index.js.- Run the tool a second time and use the new
JWT_SECRETvalue for theJWT_REFRESH_SECRET
| Variables | Values |
|---|---|
| APP_TITLE | LibreChat |
| ALLOW_REGISTRATION | true |
Deployment
1. When you're done filling the secrets and variables, click Duplicate Space in the bottom of that window
2. The project will now build, this will take a couple of minutes
3. When ready, Building will change to Running
And you will be able to access LibreChat!
Update
To update LibreChat, simply select Factory Reboot from the ⚙️Settings menu
Conclusion
You can now access it with from the current URL. If you want to access it without the Hugging Face overlay, you can modify this URL template with your info:
https://username-projectname.hf.space/
e.g. https://cooluser-librechat.hf.space/