Releases: danny-avila/LibreChat
v0.5.2
What's Changed
Features:
- feat(Functions Agent): use official langchain function executor/agent for better output handling by @danny-avila in #538
- feat(Plugins): change default agent to functions and skip completion by @danny-avila in #544
- This is the most token-efficient method of using plugins. Docs on how to write plugins as functions coming soon.
- OpenID Authentication by @bsu3338 in #495
Build and Docker Updates:
- build(docker-compose.yml): change the image name to librechat by @danny-avila in #530
- #531: Create container.yml: build and push docker image upon tagging by @jinzishuai in #536
- feat: update Dockerfile to include curl by @jinzishuai in #539
Style and UX:
- style: mobile optimizations, use fixed dialogs, and prevent auto-scroll for presets by @danny-avila in #534
- fix(SubmitButton.jsx): fix padding overlap of textarea by @danny-avila in #540
Documentation & Logos:
- Update [logo] README.md by @fuegovic in #535
- MkDocs for Material by @bsu3338 in #545
- Enhanced Documentation: Added Cloudflare and Linode Setup by @berry-13 in #549
- Minor OpenID Documentation Update by @bsu3338 in #553
- Add social sites to MkDocs by @bsu3338 in #554
Refactoring and Fixes:
- refactor: update references from chatgpt-clone to LibreChat by @fuegovic in #541
- fix: #546 issue with closing registration by @danorlando in #547
New Contributors
- @jinzishuai made their first contribution in #536
- @bsu3338 made their first contribution in #495
- @berry-13 made their first contribution in #549
Full Changelog: v0.5.1...v0.5.2
v0.5.1
What's Changed
Features:
- Option to use new OpenAI Functions with Plugins Agent by @danny-avila in #521
- feat(OpenAI, PaLM): Add model support for new OpenAI models and codechat-bison by @danny-avila in #516
- Command line features: Create a user & more install options by @ClaraLeigh in #487
- Feat/startup config api to handle Frontend environment variables more reliably by @danorlando in #518
Bug Fixes:
- fix(logout.controller.js): destructure logoutUser function by @danny-avila in #482
- fix(DALL-E.js): should only use DALLE_API_KEY in all cases by @danny-avila in #506
- fix: prepare script no longer breaks local installation by @danny-avila in #512
- style(Input): remove unnecessary z-index class from input field by @danny-avila in #522
Documentation:
- docs: fix outdated references by @fuegovic in #480
- docs update by @fuegovic in #508
- Create HetznerUbuntuSetup.md by @heathriel in #492
- docs: fix/update by @fuegovic in #525
Tests and Refactor:
- test: frontend jest ci/cd & minor fixes post-release by @danny-avila in #478
- refactor: Settings, General Tab & DialogTemplate to TS, Fix Conversation Clearing Bug, Add Tests by @danny-avila in #485
- tests(api): refactor to mock database and network operations by @danny-avila in #494
Docker and Dev Environment:
- Change prepare script to not run in CI mode and remove --ignore-scripts flag from workflow by @danorlando in #491
- Update .dockerignore by @thunderbug1 in #510
- fix(nodemon): will now follow nodemonConfig in package file by @danny-avila in #514
- fully dockerized development with VS-code devcontainers by @thunderbug1 in #524
- Update stable_diffusion.md by @thunderbug1 in #523
- Update docker, Minor Styling fix by @danny-avila in #528
New Contributors:
- @thunderbug1 made their first contribution in #510
- @heathriel made their first contribution in #492
Full Changelog: v0.5.0...v0.5.1
v0.5.0
🎉 Introducing Plugins via LangChain 🦜️🔗
⚠️ Note: this update introduces Breaking Changes ⚠️ See notes below for more information
The following contributors were crucial for this release: @fuegovic @danorlando @ClaraLeigh @dncc89
The new Plugins endpoint opens the door to prompting LLMs in new ways other than traditional input/output prompting.
The first step is using chain-of-thought prompting for using plugins/tools in a fashion mimicing the official ChatGPT Plugins feature.
More than this, you can use this endpoint for changing your conversation settings mid-conversation. Unlike the official ChatGPT site and all other endpoints, you can switch models, presets, and settings mid-convo, even when you have no plugins selected. This is useful if you first want a creative response from GPT-4, and then a deterministic, lower cost response from GPT-3.
Soon, you will be able to use Local LLMs, PaLM2 and HuggingFace models, all in this endpoint in the same modular manner.
Click here for more detailed information on this update, including how it works, how to setup specific plugins like Stable Diffusion, and how to make your own plugins compatible with this project
Immediate Roadmap
- Vector Indexing & Memory - Chat with Documents
- Starting work
- Python API to utilize Most up-to-date Python Features/Tools (including Langchain & more)
- already in progress: https://github.com/danny-avila/ai-services
- OpenAPI Support (ChatGPT plugins)
- already in progress, testing working method
- Local LLM Support
- in planning phase, methods already outlined
- HuggingFace Models Support
- in planning phase, methods already outlined
- Code-Bison Compatibility
- in planning phase, methods already outlined
- More tests and CI/CD pipeline
- already in progress, multiple test suites across the full stack are added with this update
ℹ️ If you would like to contribute to any of the above or in any other capacity, we will be adding all of these tasks & more to our GitHub Projects tab very soon. Please also join our discord for developer discussion.
Note: You can now close registration by either omitting this env variable or setting it to false
# ALLOW_REGISTRATION=true
# ...or
ALLOW_REGISTRATION=false
⚠️ Breaking Changes ⚠️
Note: These changes only apply to users who are updating from a previous version of the app.
- We have simplified the configuration process by using a single
.env
file in the root folder instead of separate/api/.env
and/client/.env
files. - If you had installed a previous version, you can run
npm run upgrade
to automatically copy the content of both files to the new.env
file and backup the old ones in the root dir. - If you are installing the project for the first time, it's recommend you run the installation script
npm run install
to guide your local setup (otherwise continue to use docker) - The docker-compose file had some changes. Review the new docker instructions to make sure you are setup properly. This is still the simplest and most effective method.
- The upgrade script requires both
/api/.env
and/client/.env
files to run properly. If you get an error about a missing client env file, just rename the/client/.env.example
file to/client/.env
and run the script again. - We have renamed the
OPENAI_KEY
variable toOPENAI_API_KEY
to match the official documentation. The upgrade script should do this automatically for you, but please double-check that your key is correct in the new.env
file. - After running the upgrade script, the
OPENAI_API_KEY
variable might be placed in a different section in the new.env
file than before. This does not affect the functionality of the app, but if you want to keep it organized, you can look for it near the bottom of the file and move it to its usual section.
- For enhanced security, we are now asking for crypto keys for securely storing credentials in the
.env
file. Crypto keys are used to encrypt and decrypt sensitive data such as passwords and access keys. If you don't set them, the app will crash on startup. - You need to fill the following variables in the
.env
file with 32-byte (64 characters in hex) or 16-byte (32 characters in hex) values:CREDS_KEY
(32-byte)CREDS_IV
(16-byte)JWT_SECRET
(32-byte, optional but recommended)
- You can use this replit to generate some crypto keys quickly: https://replit.com/@daavila/crypto#index.js
- Make sure you keep your crypto keys safe and don't share them with anyone.
We apologize for any inconvenience caused by these changes. We hope you enjoy the new and improved version of our app!
If you're having trouble with this update, visit our #issues thread on our discord, or our troubleshooting discussion on our Discussions page. Report bugs in our Issues Page
Full Changelog: v0.4.8...v0.5.0
v0.4.8
ChatGPT Clone is now LibreChat 🎉
This project has evolved a lot since it first started, and I'm happy to say it keeps improving thanks to community support, so much so that it can't simply be called a ChatGPT Clone anymore. While the UI/design will continue to stay true to chat.openai.com, it's evident this project is standing out among a sea of ChatGPT Clones. The name was first introduced by @ClaraLeigh and was favored by the community over other options. I like the Latin emphasis of Libre, which is understood in software to mean "With very few limitations on distribution or the right to access the source code to create improved versions." This project will continue to emphasize and utilize open-source solutions and philosophies, to improve upon its origin for those who build and use it.
What's next
The next release will introduce the new plugins endpoint to the project, which opens the door to plugins and chain-of-thought prompting, and later, along with additional LLMs and plugins, other forms of prompting over traditional input/outputs.
The plugins endpoint allows the use of tools in a way similar to the official ChatGPT Plugins feature. It also enables changing conversation settings, including models, presets, and settings, mid-conversation, even without plugins. This is beneficial for varying responses between different models like GPT-4 and GPT-3. Future updates will introduce PaLM2 and HuggingFace models and tree-of-thought prompting to the endpoint.
For more info before the update goes live, you can read here or try out the langchain branch yourself.
What's Changed
- Updates: Documentation, typo, and UI phrasing improvements by @fuegovic (#389, #391, #393, #414)
- Features: Clear button in search bar by @fuegovic and @techwithanirudh (#328)
- Addition: User Settings Modal by @techwithanirudh (#342)
- Style: Dropdown menu background color change by @danny-avila (#419)
- Chores:
- API package updates by @danny-avila (#404, #424)
- Tokenizer improvement and testing by @danny-avila (#417)
- Package bumps by @danny-avila (#448, #449, #450, #451, #452, #453, #435, #442)
Full Changelog: v0.4.7...v0.4.8
v0.4.7
What's Changed
Features/updates
- feat: Setup Unit Test Environment and Refactor Typescript Config by @danorlando in #365
- Setup tests with new user system as well as for message streams by @danny-avila in #344 & #387
- docs : update & cleanup the documentation by @fuegovic @danny-avila @ocontant in #345 #347 #350 #367 #379
- Enable message regeneration for bingAI endpoint by @danny-avila in #349
- @dependabot update dependencies
- refactor: remove bcrypt by @danorlando in #375
- chore(api): remove unused crypto dependency from package.json by @danny-avila in #381
Fixes
- Fix Input losing focus in all endpoints aside from openAI by @danny-avila in #382
- Hotfix by @danny-avila in #334
- fix(Bing): Use full cookies string instead of just _U cookie by @danny-avila in #369
- UI fixes & changes #335 #337
- Minor fixes: tokenizer, default Bing toneStyle, SiblingSwitch by @danny-avila in #348
- Fix (PaLM2): Persist PaLM presets after initial message by @danny-avila in #366
- fix (PaLM2): messages will properly regenerate by @danny-avila in #368
Upcoming
This is the last minor release before we introduce plugins, now that all major known bugs on main branch are taken care of. We are switching to Test-driven development and this is aiding in discovering bugs before merging
Full Changelog: v0.4.6...v0.4.7
v0.4.6
What's Changed
Features
- Closable sidebar by @techwithanirudh in #324
- Added functionality to allow users to set custom OpenAI api keys by @techwithanirudh in #276
- feat: Frontend app title environment variable by @dncc89 in #291
- feat (presets): hide/show endpoints, increase preset menu size by @danny-avila in #320
- Calculate token usage for streaming chat by @p4w4n in #287
Fixes
- Docs/security guideline by @ocontant in #295
- fix duplicate mac install instructions by @johntiger1 in #310
- fix(api): fix support for user-provided OpenAI API key by @danny-avila in #311
- Fix title for document object by @danny-avila in #313
- Build/Refactor: lint pre-commit hook and reformat repo to spec by @danorlando in #314 #316 #317
- minor fixes by @danny-avila in #318
- bump dependencies using @dependabot
- fix(User.js, auth.service.js, localStrategy.js): change deprecated Joi.validate() to schema.validate() method by @danny-avila in #322
- fix(auth.service.js): fixes deprecated error callback in mongoose save method by @danny-avila in #323
- Fixes all Nav Menu related errors and bugs by @danny-avila in #331
New Contributors
- @johntiger1 made their first contribution in #310
- @dependabot introduced in #296
Full Changelog: v0.4.5...v0.4.6
v0.4.5
What's Changed
- Sydney is working again!
- Fix: install instructions by @fuegovic in #272
- fix: New GPT-4 model icon in presets and chat input by @dncc89 in #274
- feat: Add user icon in messages by @dncc89 in #275
- fix(getIcon.jsx): match initial styling better with official by @danny-avila in #277
- doc: coding conventions and proposal submissions by @danorlando in #250
- fix: fix link to coding conventions doc in contributor guidelines by @danorlando in #283
- docs : add basic info document in multiple languages by @fuegovic in #285
- #282 :
- Update @waylaidwanderer/node-chatgpt-api to latest version
- Update dockerfiles to use workspaces and ensure packages are @ latest
- Remove package-lock.json files from workspace directories as no longer needed
- refactor(api): remove deprecated text-davinci-002-render-paid model from CHATGPT_MODELS
- refactor(api/client): change model comparison to use startsWith() instead of === for GPT-4 models
Note: you can use all available models on chat.openai.com through the browser endpoint, including code interpreter, browsing, and plugins if you have access, though their full features are not fully supported in this project (mainly loading plugins). I haven't tested the interpreter as I don't have access, but plugins & browser gives you greater context (up to 8100 tokens), and the browser is useful for web knowledge. For more info, see discussion here: #284
In short, you simply need to add the models to this env var in your api/.env file
CHATGPT_MODELS=text-davinci-002-render-sha,gpt-4,gpt-4-browsing,gpt-4-plugins
Full Changelog: v0.4.4...v0.4.5
v0.4.4
What's Changed
- Msg Clipboard to checkmark (optimistic UX) by @techwithanirudh in #247
- Correct the typo in auth.json path for accessing Google Palm by @antonme in #266
- Add Popup Menu to Save Space in Sidebar by @techwithanirudh in #260
- refactor(Conversation.js): change default pageSize from 12 to 14 by @danny-avila in #267
- Fonts by @techwithanirudh in #261
- refactor(style.css): change font file paths by @danny-avila in #268
- fix code to adjust max_tokens according to model selection by @p4w4n in #263
- Fix react errors, max context tokens, and preset mobile view by @danny-avila in #269
New Contributors
- @techwithanirudh made their first contribution in #247
- @antonme made their first contribution in #266
- @p4w4n made their first contribution in #263
Full Changelog: v0.4.3...v0.4.4
v0.4.3
What's Changed
- chore: NPM Workspaces and scripts by @ClaraLeigh in #244
- Feat: PaLM 2 by @danny-avila in #262
How to Use PaLM 2 (via Google Cloud Vertex AI API)
- Enable the Vertex AI API on Google Cloud:
- Create a Service Account:
- Make sure to click 'Create and Continue' to give at least the 'Vertex AI User' role.
- Create a JSON key, rename as 'auth.json' and save it in /api/data/.
Alternatively
- In your ./api/.env file, set PALM_KEY as "user_provided" to allow the user to provide a Service Account key JSON from the UI.
- They will follow the steps above except for renaming the file, simply importing the JSON when prompted.
- The key is sent to the server but never saved except in your local storage
Note:
- Vertex AI does not (yet) support response streaming for text generations, so response may seem to take long when generating a lot of text.
- Text streaming is simulated
New Contributors
- @ClaraLeigh made their first contribution in #244
Full Changelog: v0.4.2...v0.4.3
v0.4.2
What's Changed
- refactor(getCitations.js): add null check for adaptiveCards variabl… by @qcgm1978 in #232
- feat: add support for titling convos with azure endpoint by @danny-avila in #234
- fix(titleConvo.js, endpoints.js): fix titling with azure, fix endpoints unavailable when only azure key is provided by @danny-avila in #235
- Feature/logging system with pino and sanitization (#214) by @danorlando in #227
- fix(docker): update .dockerignore to include client/.env file by @danny-avila in #241
- Release 0.4.2 by @danny-avila in #242
New Contributors
Upcoming
There is active work on the new Plugins feature, converting the frontend to Typescript, and looking to integrate Palm2, google's new generative AI accessible via API, to the project as a new endpoint.
Full Changelog: v0.4.1...v0.4.2