2023-06-24 22:00:10 -05:00
|
|
|
# Project information
|
2023-07-01 20:11:37 -04:00
|
|
|
site_name: LibreChat
|
2023-06-24 22:00:10 -05:00
|
|
|
|
|
|
|
|
# Repository
|
|
|
|
|
repo_name: danny-avila/LibreChat
|
|
|
|
|
repo_url: https://github.com/danny-avila/LibreChat
|
2023-07-01 20:11:37 -04:00
|
|
|
#edit_uri: ''
|
|
|
|
|
edit_uri: blob/main/docs/
|
|
|
|
|
|
|
|
|
|
#set use_directory_urls to false to make the HTML embed use the same relative paths as in GitHub
|
|
|
|
|
use_directory_urls: false
|
2023-06-24 22:00:10 -05:00
|
|
|
|
|
|
|
|
theme:
|
|
|
|
|
name: material
|
2023-07-01 20:11:37 -04:00
|
|
|
logo: assets/LibreChat.svg
|
|
|
|
|
favicon: assets/favicon_package/favicon-32x32.png
|
|
|
|
|
|
2023-06-24 22:00:10 -05:00
|
|
|
palette:
|
2023-07-01 20:11:37 -04:00
|
|
|
|
2023-06-24 22:00:10 -05:00
|
|
|
# Palette toggle for dark mode
|
|
|
|
|
- scheme: slate
|
2023-07-01 20:11:37 -04:00
|
|
|
primary: cyan
|
|
|
|
|
accent: purple
|
2023-06-24 22:00:10 -05:00
|
|
|
toggle:
|
|
|
|
|
icon: material/brightness-4
|
|
|
|
|
name: Switch to light mode
|
2023-08-19 20:11:31 +09:00
|
|
|
|
2023-06-24 22:00:10 -05:00
|
|
|
# Palette toggle for light mode
|
|
|
|
|
- scheme: default
|
2023-07-01 20:11:37 -04:00
|
|
|
primary: cyan
|
|
|
|
|
accent: purple
|
2023-06-24 22:00:10 -05:00
|
|
|
toggle:
|
2023-08-19 20:11:31 +09:00
|
|
|
icon: material/brightness-7
|
2023-06-24 22:00:10 -05:00
|
|
|
name: Switch to dark mode
|
2023-08-19 20:11:31 +09:00
|
|
|
|
2023-06-24 22:00:10 -05:00
|
|
|
icon:
|
2023-07-01 20:11:37 -04:00
|
|
|
repo: fontawesome/brands/github
|
2023-06-24 22:00:10 -05:00
|
|
|
edit: material/pencil
|
|
|
|
|
view: material/eye
|
2023-08-19 20:11:31 +09:00
|
|
|
|
2023-06-24 22:00:10 -05:00
|
|
|
features:
|
2023-07-01 20:11:37 -04:00
|
|
|
- header.autohide
|
2023-06-24 22:00:10 -05:00
|
|
|
- navigation.tabs
|
|
|
|
|
- navigation.tabs.sticky
|
|
|
|
|
- content.action.edit
|
|
|
|
|
- content.code.copy
|
2023-07-01 20:11:37 -04:00
|
|
|
- navigation.instant
|
|
|
|
|
- navigation.tracking
|
|
|
|
|
- navigation.expand
|
|
|
|
|
# - navigation.sections
|
2023-06-24 22:00:10 -05:00
|
|
|
|
2023-07-01 20:11:37 -04:00
|
|
|
# For more Styling options (not in use)
|
|
|
|
|
extra_css:
|
|
|
|
|
- stylesheets/extra.css
|
2023-06-27 07:57:40 -05:00
|
|
|
|
2023-06-24 22:00:10 -05:00
|
|
|
markdown_extensions:
|
2023-07-01 20:11:37 -04:00
|
|
|
- pymdownx.highlight:
|
|
|
|
|
anchor_linenums: true
|
|
|
|
|
- pymdownx.inlinehilite
|
|
|
|
|
- pymdownx.snippets
|
2023-06-24 22:00:10 -05:00
|
|
|
- admonition
|
2023-07-01 20:11:37 -04:00
|
|
|
- pymdownx.arithmatex:
|
|
|
|
|
generic: true
|
|
|
|
|
- footnotes
|
2023-06-24 22:00:10 -05:00
|
|
|
- pymdownx.tasklist:
|
|
|
|
|
custom_checkbox: true
|
2023-07-01 20:11:37 -04:00
|
|
|
- pymdownx.details
|
|
|
|
|
- pymdownx.superfences
|
|
|
|
|
- pymdownx.mark
|
|
|
|
|
- attr_list
|
2023-06-24 22:00:10 -05:00
|
|
|
- pymdownx.emoji:
|
|
|
|
|
emoji_index: !!python/name:materialx.emoji.twemoji
|
|
|
|
|
emoji_generator: !!python/name:materialx.emoji.to_svg
|
|
|
|
|
|
|
|
|
|
# Page tree
|
|
|
|
|
nav:
|
2023-08-19 20:11:31 +09:00
|
|
|
- Home:
|
2023-07-01 20:11:37 -04:00
|
|
|
- 'index.md'
|
2023-07-03 01:08:29 -04:00
|
|
|
- v0.5.0 Breaking Changes: 'general_info/breaking_changes.md'
|
2023-07-01 20:11:37 -04:00
|
|
|
- Project Origin: 'general_info/project_origin.md'
|
2023-08-19 20:11:31 +09:00
|
|
|
- Tech Stack: 'general_info/tech_stack.md'
|
2023-07-01 20:11:37 -04:00
|
|
|
- Multilingual Information: 'general_info/multilingual_information.md'
|
2023-07-23 20:34:41 -04:00
|
|
|
- Installation Guides:
|
2023-07-27 14:05:49 +02:00
|
|
|
- Installation:
|
2023-08-24 20:24:47 -04:00
|
|
|
- Docker (Compose) Install: 'install/docker_compose_install.md'
|
|
|
|
|
- Container Install: 'install/container_install.md'
|
2023-07-27 14:05:49 +02:00
|
|
|
- Linux Install: 'install/linux_install.md'
|
|
|
|
|
- Mac Install: 'install/mac_install.md'
|
|
|
|
|
- Windows Install: 'install/windows_install.md'
|
|
|
|
|
- Configuration:
|
|
|
|
|
- Free AI APIs: 'install/free_ai_apis.md'
|
|
|
|
|
- APIs and Tokens: 'install/apis_and_tokens.md'
|
|
|
|
|
- User Auth System: 'install/user_auth_system.md'
|
|
|
|
|
- Online MongoDB Database: 'install/mongodb.md'
|
2023-08-26 19:36:25 -04:00
|
|
|
- Languages: 'install/default_language.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Features:
|
|
|
|
|
- Plugins:
|
|
|
|
|
- Introduction: 'features/plugins/introduction.md'
|
|
|
|
|
- Google: 'features/plugins/google_search.md'
|
|
|
|
|
- Stable Diffusion: 'features/plugins/stable_diffusion.md'
|
|
|
|
|
- Wolfram: 'features/plugins/wolfram.md'
|
2023-08-19 20:11:31 +09:00
|
|
|
- Azure Cognitive Search: 'features/plugins/azure_cognitive_search.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Make Your Own Plugin: 'features/plugins/make_your_own.md'
|
2023-07-16 13:14:07 -04:00
|
|
|
- Using official ChatGPT Plugins: 'features/plugins/chatgpt_plugins_openapi.md'
|
feat: Message Rate Limiters, Violation Logging, & Ban System 🔨 (#903)
* refactor: require Auth middleware in route index files
* feat: concurrent message limiter
* feat: complete concurrent message limiter with caching
* refactor: SSE response methods separated from handleText
* fix(abortMiddleware): fix req and res order to standard, use endpointOption in req.body
* chore: minor name changes
* refactor: add isUUID condition to saveMessage
* fix(concurrentLimiter): logic correctly handles the max number of concurrent messages and res closing/finalization
* chore: bump keyv and remove console.log from Message
* fix(concurrentLimiter): ensure messages are only saved in later message children
* refactor(concurrentLimiter): use KeyvFile instead, could make other stores configurable in the future
* feat: add denyRequest function for error responses
* feat(utils): add isStringTruthy function
Introduce the isStringTruthy function to the utilities module to check if a string value is a case-insensitive match for 'true'
* feat: add optional message rate limiters by IP and userId
* feat: add optional message rate limiters by IP and userId to edit route
* refactor: rename isStringTruthy to isTrue for brevity
* refactor(getError): use map to make code cleaner
* refactor: use memory for concurrent rate limiter to prevent clearing on startup/exit, add multiple log files, fix error message for concurrent violation
* feat: check if errorMessage is object, stringify if so
* chore: send object to denyRequest which will stringify it
* feat: log excessive requests
* fix(getError): correctly pluralize messages
* refactor(limiters): make type consistent between logs and errorMessage
* refactor(cache): move files out of lib/db into separate cache dir
>> feat: add getLogStores function so Keyv instance is not redundantly created on every violation
feat: separate violation logging to own function with logViolation
* fix: cache/index.js export, properly record userViolations
* refactor(messageLimiters): use new logging method, add logging to registrations
* refactor(logViolation): make userLogs an array of logs per user
* feat: add logging to login limiter
* refactor: pass req as first param to logViolation and record offending IP
* refactor: rename isTrue helper fn to isEnabled
* feat: add simple non_browser check and log violation
* fix: open handles in unit tests, remove KeyvMongo as not used and properly mock global fetch
* chore: adjust nodemon ignore paths to properly ignore logs
* feat: add math helper function for safe use of eval
* refactor(api/convos): use middleware at top of file to avoid redundancy
* feat: add delete all static method for Sessions
* fix: redirect to login on refresh if user is not found, or the session is not found but hasn't expired (ban case)
* refactor(getLogStores): adjust return type
* feat: add ban violation and check ban logic
refactor(logViolation): pass both req and res objects
* feat: add removePorts helper function
* refactor: rename getError to getMessageError and add getLoginError for displaying different login errors
* fix(AuthContext): fix type issue and remove unused code
* refactor(bans): ban by ip and user id, send response based on origin
* chore: add frontend ban messages
* refactor(routes/oauth): add ban check to handler, also consolidate logic to avoid redundancy
* feat: add ban check to AI messaging routes
* feat: add ban check to login/registration
* fix(ci/api): mock KeyvMongo to avoid tests hanging
* docs: update .env.example
> refactor(banViolation): calculate interval rate crossover, early return if duration is invalid
ci(banViolation): add tests to ensure users are only banned when expected
* docs: improve wording for mod system
* feat: add configurable env variables for violation scores
* chore: add jsdoc for uaParser.js
* chore: improve ban text log
* chore: update bun test scripts
* refactor(math.js): add fallback values
* fix(KeyvMongo/banLogs): refactor keyv instances to top of files to avoid memory leaks, refactor ban logic to use getLogStores instead
refactor(getLogStores): get a single log store by type
* fix(ci): refactor tests due to banLogs changes, also make sure to clear and revoke sessions even if ban duration is 0
* fix(banViolation.js): getLogStores import
* feat: handle 500 code error at login
* fix(middleware): handle case where user.id is _id and not just id
* ci: add ban secrets for backend unit tests
* refactor: logout user upon ban
* chore: log session delete message only if deletedCount > 0
* refactor: change default ban duration (2h) and make logic more clear in JSDOC
* fix: login and registration limiters will now return rate limiting error
* fix: userId not parsable as non ObjectId string
* feat: add useTimeout hook to properly clear timeouts when invoking functions within them
refactor(AuthContext): cleanup code by using new hook and defining types in ~/common
* fix: login error message for rate limits
* docs: add info for automated mod system and rate limiters, update other docs accordingly
* chore: bump data-provider version
2023-09-13 10:57:07 -04:00
|
|
|
- Automated Moderation: 'features/mod_system.md'
|
|
|
|
|
- Third-Party Tools: 'features/third_party.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Proxy: 'features/proxy.md'
|
2023-08-19 20:11:31 +09:00
|
|
|
- Bing Jailbreak: 'features/bing_jailbreak.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Cloud Deployment:
|
2023-08-10 10:03:59 -04:00
|
|
|
- DigitalOcean (preferred): 'deployment/digitalocean.md'
|
2023-07-01 20:11:37 -04:00
|
|
|
- Cloudflare: 'deployment/cloudflare.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Hetzner: 'deployment/hetzner_ubuntu.md'
|
|
|
|
|
- Heroku: 'deployment/heroku.md'
|
2023-06-26 15:23:50 +02:00
|
|
|
- Linode: 'deployment/linode.md'
|
2023-07-05 15:20:23 +02:00
|
|
|
- Ngrok: 'deployment/ngrok.md'
|
2023-07-14 09:40:41 -04:00
|
|
|
- Render: 'deployment/render.md'
|
2023-08-04 14:41:34 -04:00
|
|
|
- Azure (Terraform): 'deployment/azure-terraform.md'
|
2023-09-01 08:12:35 -04:00
|
|
|
- HuggingFace: 'deployment/huggingface.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Contributions:
|
|
|
|
|
- Documentation Guidelines: 'contributions/documentation_guidelines.md'
|
2023-08-26 19:36:25 -04:00
|
|
|
- Contribute a Translation: 'contributions/translation_contribution.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
- Code Standards and Conventions: 'contributions/coding_conventions.md'
|
2023-08-01 14:14:01 +02:00
|
|
|
- Testing: 'contributions/testing.md'
|
2023-06-24 22:00:10 -05:00
|
|
|
|
2023-07-01 20:11:37 -04:00
|
|
|
extra:
|
|
|
|
|
social:
|
|
|
|
|
- icon: fontawesome/brands/discord
|
|
|
|
|
link: https://discord.gg/CEe6vDg9Ky
|
|
|
|
|
- icon: fontawesome/brands/github
|
|
|
|
|
link: https://github.com/danny-avila/LibreChat
|
|
|
|
|
- icon: fontawesome/brands/youtube
|
2023-08-19 20:11:31 +09:00
|
|
|
link: https://www.youtube.com/@LibreChat
|
2023-07-01 20:11:37 -04:00
|
|
|
|
|
|
|
|
copyright:
|
2023-07-03 01:08:29 -04:00
|
|
|
© 2023 <a href="https://github.com/danny-avila/LibreChat" target="_blank" rel="noopener">LibreChat</a>
|