Commit Graph

102 Commits

Author SHA1 Message Date
Claude
04547d128a fix: remove deprecated Nextra framework, upgrade ESLint v8→v9, migrate pages/ to app/ router
- Delete entire pages/ directory and Nextra compatibility shims (lib/nextra-shims/, theme.config.tsx)
- Migrate toolkit, subscribe, and unsubscribe routes to app/ router with proper server/client component split
- Remove Nextra webpack aliases, _meta loader, and pages/ MDX include from next.config.mjs
- Replace Nextra MDX provider with minimal lib/mdx-provider.ts for components/ directory MDX files
- Add redirects for old toolkit URLs (yaml_checker → yaml-checker, creds_generator → creds-generator)
- Upgrade ESLint 8→9 with ESLINT_USE_FLAT_CONFIG=false for legacy config compatibility
- Remove unused devDependencies: eslint-plugin-mdx, eslint-plugin-tailwindcss
- Upgrade eslint-config-prettier, eslint-plugin-prettier, eslint-plugin-react, eslint-plugin-unicorn
- Clean up .eslintrc.cjs: remove dead Nextra/packages override blocks, fix React rules file pattern
- Delete unused components: Author/*, blog/BlogCard, blog/BlogHeader, home/Changelog, policies
- Fix lint errors: remove unused React imports, rename .tsx→.ts where no JSX, useMemo([])→useRef().current

https://claude.ai/code/session_01YKUFdMxJkWudwuKyTQHqDB
2026-02-19 10:27:21 +00:00
Marco Beretta
8742a19a9c Update roadmap links from 2025 to 2026 (#507) 2026-02-19 09:47:28 +01:00
Danny Avila
9e1a0db393 rel/v0.8.3-rc1-v2 (#504)
* chore: update GitHub Actions workflow to use latest action version for improved stability

* chore: update roadmap references and enhance documentation for AWS Bedrock inference profiles

- Updated footer menu and card icons to reflect the 2026 roadmap.
- Adjusted default values in changelog and configuration documentation for `maxRecursionLimit`.
- Added comprehensive documentation for AWS Bedrock inference profiles, including setup, configuration, and examples.
- Introduced Agents API documentation for programmatic access to LibreChat agents.
- Enhanced existing documentation for clarity and consistency across various sections.

* feat: release Config v1.3.4 with new features and updates

- Introduced `create` field in `interface.prompts` and `interface.agents` for enhanced user control.
- Added `interface.remoteAgents` configuration for managing remote agent permissions.
- Updated `endpoints.bedrock` with `models` and `inferenceProfiles` for better customization.
- Included Moonshot as a known endpoint for AI integration.
- Introduced new agent capabilities: `deferred_tools` and `programmatic_tools`.
- Removed deprecated `forcePrompt` setting from configurations.
- Updated default model lists and added support for new models.
- Enhanced `modelSpecs` with `artifacts` field and `effort` parameter for Anthropic models.

* refactor: update BlogHeader to use usePathname for route handling

- Replaced useRouter with usePathname for improved routing in BlogHeader component.
- Simplified page retrieval logic by directly using pathname for matching routes.

* feat: add changelog for v0.8.3-rc1 release with new features and fixes

- Introduced several enhancements including event-driven lazy tool loading, token usage tracking, and programmatic tool calling UI.
- Added support for new models and providers, including Claude Opus 4.6 and Moonshot.
- Implemented various bug fixes and improvements for better user experience and performance.

* chore: nextjs artifact

* first draft roadmap

* feat: enhance BlogPage with Open Graph image support and layout improvements

- Added support for Open Graph images in blog entries to improve visual presentation.
- Refactored article layout for better structure and readability, including adjustments to the display of metadata and content.
- Updated styles for improved user experience during hover interactions.

* feat: enhance BlogPage with date formatting and layout adjustments

- Added a new dateFormatted field to entries for improved date display.
- Implemented a date formatter for consistent date presentation.
- Refactored article layout to use a grid system for better responsiveness.
- Updated styles for article links and metadata for enhanced user experience.

* feat: add responsive image sizes to BlogPage for improved layout

- Included sizes attribute for Open Graph images to enhance responsiveness on different screen sizes.

* feat: update feature titles and descriptions for clarity

- Changed titles for "Forking Messages and Conversations" to "Forking Chats" and "Memory" to "User Memory" for better alignment with functionality.
- Updated descriptions for "Message Search" and "Upload as Text" to enhance understanding of features.

* chore: update configuration version to 1.3.4 across multiple documentation files

- Updated the version number in `librechat.yaml` examples to reflect the latest release (1.3.4) in various configuration and feature documentation files.

* feat: enhance User Memory documentation for clarity and detail

- Updated the description to clarify that User Memory is a key/value store that operates on every chat request.
- Added a callout to distinguish between key/value storage and conversation memory.
- Expanded on the functionality of the memory agent, including its execution process and user control features.
- Introduced a section on future improvements for the memory agent's efficiency and relevance.

* feat: update title and description for NGINX documentation

- Changed the title from "Secure Deployment with Nginx" to "NGINX" for brevity.
- Updated the description to provide a clearer overview of the guide's purpose in securing LibreChat deployment with Nginx as a reverse proxy and HTTPS.

* feat: update 2026 roadmap with key accomplishments and future plans

- Celebrated LibreChat's 3rd anniversary with a summary of achievements from 2025, including growth in GitHub stars and community engagement.
- Clarified the timeline for open-sourcing the Code Interpreter API by the end of Q1.
- Revised notes on the v1 Admin Panel's core capabilities and community-driven items for better clarity and detail.

* feat: enhance blog and author components with Open Graph image support

- Added optional `ogImagePosition` field to blog entries for better image placement control.
- Updated BlogPage and individual post pages to utilize the new `ogImagePosition` for responsive image styling.
- Improved Author component to conditionally render author images based on availability.
- Updated 2026 roadmap blog post with a new Open Graph image and position for enhanced visual appeal.

* feat: enhance CardComponent with icon support and layout improvements

- Added optional `icon` prop to CardComponent for better visual representation.
- Updated CardComponent layout to include icon alongside title and children.
- Improved styling for CardComponent and CardsBase for enhanced responsiveness and user experience.

* feat: update 2026 roadmap with detailed focus areas and community-driven items

- Added sections for Q1 and Q2 focus areas, outlining major initiatives like Dynamic Context and Admin Panel.
- Enhanced clarity on community-driven items and their prioritization based on GitHub reactions.
- Included hiring information to attract full-stack developers for ongoing project support.
- Improved overall structure and readability of the roadmap content.

* fix: improve icon styling in CardCompat component for better responsiveness

- Updated icon container styling to ensure consistent height and width for SVG icons.
- Enhanced layout of CardCompat to maintain visual integrity across different screen sizes.

* chore: update .gitignore to include next-env.d.ts for TypeScript support

* fix: correct import statement formatting in next-env.d.ts for consistency

* fix: refine wording in 2026 roadmap for clarity

- Updated the description of agentic workflows to emphasize a lean approach to context pulling.
- Enhanced overall readability of the section on Dynamic Context.

* feat: expand Admin Panel section in 2026 roadmap with detailed capabilities

- Added comprehensive descriptions of the Admin Panel's core functionalities, including GUI for configuration, configuration profiles, group and role management, and access controls.
- Clarified the development approach for the Admin Panel, emphasizing ongoing iteration and community involvement.
- Updated note on the Admin Panel's prioritization and requirements following the ClickHouse acquisition.

* feat: add TrackedLink component for enhanced analytics tracking

- Introduced a new TrackedLink component that integrates Vercel analytics to track user interactions with links.
- The component allows for customizable link properties while ensuring tracking of clicks with relevant metadata.
- Updated CardCompat to utilize the new TrackedLink for improved user engagement tracking.

* feat: enhance blog post layout and introduce TrackedAnchor component for link tracking

- Wrapped the InlineTOC component in a div for improved spacing in blog posts.
- Added a new TrackedAnchor component to facilitate link tracking with Vercel analytics, allowing for customizable anchor elements.
- Updated mdx-components to utilize TrackedAnchor for enhanced link interaction tracking.

* feat: update TrackedLink and TrackedAnchor components for external link handling

- Enhanced the TrackedLink component to differentiate between internal and external links, using Next.js Link for internal navigation.
- Introduced a utility function to determine if a link is external, improving tracking accuracy.
- Updated TrackedAnchor to utilize the same external link handling logic for consistency in link tracking.

* feat: add uncaught exception handling section to dotenv configuration documentation

- Introduced a new section on uncaught exception handling, explaining how to override the default behavior to keep the app running after exceptions.
- Added an option table detailing the `CONTINUE_ON_UNCAUGHT_EXCEPTION` configuration.
- Included a warning callout advising against using this feature in production environments.

* feat: add ESLint rule for unused variables in TypeScript

- Introduced a new ESLint rule to enforce the handling of unused variables, allowing for specific patterns to be ignored.
- This enhancement aims to improve code quality by ensuring that developers are alerted to potentially unnecessary variables while maintaining flexibility in naming conventions.

* fix: update copyright year in LICENSE file to 2026

* feat: update footer menu link and add 2026 roadmap blog post

- Changed the roadmap link in the FooterMenu component to point to the new blog post.
- Introduced a new blog post detailing the 2026 roadmap for LibreChat, outlining key features and focus areas for the upcoming year.
- Updated the import statement in next-env.d.ts for consistency with the new types directory.

* fix: update import path in next-env.d.ts and add comment block in agents.mdx

- Changed the import statement in next-env.d.ts to reference the new development types directory.
- Added a comment block in agents.mdx to indicate that the Programmatic Tool Calling feature is in private beta.

* fix: remove unused ESLint disable comment in context.tsx

* chore: update blog
2026-02-18 21:46:20 -05:00
Marco Beretta
e3ad59744d feat: redesign docs site pages, migrate legal/about to App Router, add feedback widget (#502)
* feat: update table of content style in DocsPage component

* feat: add feedback widget, redesign DocsHub, and add sidebar logo

* feat: update demo images for dark and light themes

* feat: update demo images for dark and light themes

* feat: replace logo image and remove duplicate SVG file

* feat: add LocalInstallHub component and update documentation for local installation

* feat: enhance UI by updating feature icons and descriptions, and improving layout responsiveness

* Add legal pages: Cookie Policy, Privacy Policy, and Terms of Service

- Implemented Cookie Policy page with details on cookie usage and user privacy.
- Created Privacy Policy page outlining data collection practices and user rights.
- Developed Terms of Service page defining the usage terms for the documentation site.
- Removed outdated MDX files for cookie, privacy, and terms of service.
- Updated FeaturesHub component to include new feature highlights and improved layout.

* feat: enhance GitHub data fetching to include contributor count and update CommunitySection layout
2026-02-19 00:06:58 +01:00
Danny Avila
bd2eb566df chore: update configuration and dependencies for improved performance and compatibility (#501)
* chore: update configuration and dependencies for improved performance and compatibility

- Refactored \`next-env.d.ts` to use import syntax for route types.
- Updated \`next.config.mjs\` to enable turbopack and removed ESLint ignore settings.
- Modified \`package.json\` and \`pnpm-lock.yaml\` to upgrade dependencies, including Next.js to version 16.1.6 and ajv to version 8.18.0.
- Adjusted build scripts in \`package.json\` to use webpack.
- Added a new \`proxy.ts\` file for handling markdown requests.
- Updated \`tsconfig.json\` to include additional TypeScript definitions for development.

* chore: update Next.js bundle analysis workflow for improved compatibility and performance

- Updated GitHub Actions workflow to use the latest versions of actions for better stability.
- Changed Node.js version to 20 and updated pnpm setup to version 4.
- Simplified ESLint command and build process by using `pnpm lint` and `pnpm build`.
- Enhanced comment handling by consolidating create/update comment steps into a single action.
- Removed deprecated steps and comments for a cleaner workflow configuration.

* chore: update package manager version in package.json

- Set packageManager to pnpm@9.5.0 for improved dependency management.

* chore: enhance Next.js bundle analysis workflow with caching and telemetry settings

- Added environment variable to disable Next.js telemetry for privacy.
- Implemented caching for Next.js build to improve workflow performance by restoring build artifacts.

* refactor: simplify credentials generation logic in credentialsGenerator.ts

- Replaced crypto module with window.crypto for generating random hex values.
- Streamlined the generateCredentials function to use concise object return syntax.
2026-02-18 13:54:27 -05:00
Marco Beretta
4656b0116a feat: Migrate to Fumadocs, overhaul UI, and improve docs navigation (#500)
* feat: enhance accessibility and improve component structure across various files

* feat: enhance components with TypeScript typings and improve documentation

- Added TypeScript interface for Screenshot component props.
- Updated button component documentation for clarity.
- Removed unnecessary console log in ContainerScroll component.
- Added descriptive comments for FloatingDock and utility functions.
- Improved CSP headers in next.config.mjs for security.
- Cleaned up package.json by removing unused dependencies.
- Refactored _app.tsx to use AppProps for type safety.
- Updated meta configuration by removing hidden display property.
- Added API documentation comments for GitHub stats and subscription endpoints.
- Enhanced error handling in subscription API.
- Updated Tailwind CSS configuration with detailed comments.
- Cleaned up style.css by organizing and refining styles.
- Updated tsconfig.json to include TypeScript files for API routes.
- Added comments to Subscriber model and dbConnect utility for clarity.

* feat: add aria-labels to HeroLinks for improved accessibility

* feat: replace Twitter icon with X and add new X icon component

* chore: update code structure for better readability and maintenance

* chore: update .gitignore to include additional AI assistant files and Claude Flow generated files

* feat: replace sidebar emojis with Lucide icons, fix duplicate titles, and clean up codebase

- Add icon resolver (lib/icons.tsx) with 73 Lucide React icons mapped to string IDs
- Wire icon resolver into Fumadocs loader for automatic sidebar icon rendering
- Update all 19 meta.json files to use icon field instead of emoji prefixes
- Add icon frontmatter to all 162 MDX documentation pages
- Deduplicate adjacent sidebar icons (e.g. Search/ListFilter, Brain/Bookmark)
- Remove duplicate H1 headings from 154 MDX files (DocsTitle renders frontmatter)
- Add frontmatter to 33 files that were missing it
- Shorten overly long titles (agents, mcp, url_query)
- Rewrite /docs/local cards from old Nextra syntax to Fumadocs Card components
- Remove all emojis from Get Started and Features index pages
- Collapse sidebar folders by default (defaultOpenLevel: 0)
- Delete temporary debugging scripts, test specs, and screenshot artifacts
- Fix eslint errors in mdx-components, nextra-shims, tailwind config, and error page
- Update .gitignore to exclude test/debug artifacts

* feat: enhance accessibility and improve UI components

- Added aria-hidden attributes to social media icons in FooterMenu for better accessibility.
- Updated FooterMenu to use <footer> element for semantic HTML.
- Improved Carousel component by adding aria-labels to navigation buttons for better screen reader support.
- Modified OptionTable to use a unique key for each row to prevent rendering issues.
- Enhanced CredentialsGeneratorBox with aria-labels for input fields and buttons to improve accessibility.
- Updated documentation to remove unnecessary links and improve clarity in various sections.
- Fixed iframe attributes in documentation for better compatibility and accessibility.
- Adjusted CSS variable for muted foreground color to improve contrast.
- Updated package.json and pnpm-lock.yaml for dependency management and optimization.

* feat: update FileComponent and FolderComponent to include new props for enhanced functionality

* Add new AI provider icons and update documentation

- Introduced new SVG icons for AI providers: TogetherAI, TrueFoundry, VLLM, Vultr, and XAI.
- Updated existing AI endpoint documentation to reflect new icon names and improve clarity.
- Replaced generic \Plug\ icons with specific provider icons for Anyscale, APIpie, Cloudflare, Cohere, Databricks, DeepSeek, Fireworks, Groq, Helicone, HuggingFace, LiteLLM, Mistral, MLX, Moonshot, NeuroChain, Ollama, OpenRouter, Perplexity, Portkey, ShuttleAI, and TrueFoundry.
- Enhanced the icon resolution logic to include new icons in the icon registry.

* feat: add DocsHub and QuickStartHub components for enhanced documentation navigation

* feat: implement FeaturesHub component for enhanced feature navigation and update ViewOptions for improved links

* feat: add fresh-build script for streamlined project setup and development

* fix: update ESLint configuration and improve type handling in components

- Added 'next.config.mjs' to ESLint ignore list.
- Refactored version assignment in ChangelogPage for better type safety.
- Removed unnecessary type casting in Author components for cleaner code.
- Simplified BlogHeader component by removing redundant type assertions.
- Added eslint-disable comments for unused variables in CardCompat and Nextra shims.

* fix: update ViewOptions link for LibreChat to remove unnecessary submit parameter

* feat: enhance HomePage layout and improve GitHub star display

- Integrated HomeLayout component for better page structure.
- Updated HeroSection to improve the presentation of GitHub stars with a new layout and styling.
- Adjusted link attributes for better accessibility and user experience.

* refactor: simplify title for Model Context Protocol (MCP) documentation

- Changed the title from "Model Context Protocol (MCP)" to "MCP" for brevity.
- Updated the description to clarify how LibreChat utilizes MCP for integration with external tools and services.

* feat: enhance navigation styling and update HomeLayout props

- Added a new background style for the navigation bar with a blur effect.
- Updated HomeLayout component to include a transparent navigation mode for improved visual integration.

* refactor: deprecate plugins in favor of agents and update related documentation

- Removed references to plugins across various files, including the FeaturesHub and documentation.
- Updated navigation redirects to point to agents instead of plugins.
- Deleted the plugins documentation file to streamline content and reduce confusion.

* feat: update demo images for improved visual representation

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
2026-02-18 10:44:38 -05:00
Danny Avila
029b32e01e v0.8.2 (#493)
* docs: add changelog for v0.8.2 release with major accessibility improvements, dynamic MCP server management, and new model support

* docs: add documentation for Resumable Streams feature, including benefits, deployment modes, and troubleshooting tips

* ⚙️ Config v1.3.3

* docs: enhance Redis configuration guide to include horizontal scaling and resumable streams details

* docs: enhance configuration documentation for various services including Anthropic via Vertex AI, AWS Bedrock, Gemini Image Generation, and CDN options for Amazon S3 and Azure Blob Storage

* docs: enhance configuration documentation for logging, file upload, and speech features, including rate limiting options and environment variable references

* docs: update changelog for v0.8.2 to reflect major accessibility improvements and new resumable LLM streams feature

* docs: update changelog for v1.3.3 to include link to promptCache model specs documentation

* docs: enhance SSRF protection documentation for allowedDomains configuration in actions and MCP settings

* docs: update release date for Config v1.3.3 in changelog
2026-01-28 17:40:37 -05:00
Danny Avila
f9f940b30e docs: add changelog for v0.8.2-rc3 release with new features, fixes, and internationalization updates 2026-01-17 17:21:06 -05:00
Dustin Healy
09aeb8a50c 📢 docs: v0.8.2-rc2 changelog (#482)
* docs: v0.8.2-rc2 changelog

* docs: add highlights section

* fix: combine internationlization and change to correct full changelog link

* fix: add back what's changed header

* chore: polish highlights

* chore: final tweaks

* Update changelog for v0.8.2-rc2

* Remove highlights from v0.8.2-rc2 changelog

Removed highlights section from the changelog for version 0.8.2-rc2.

* Update release date for v0.8.2-rc2

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
2026-01-07 12:00:56 -05:00
Dustin Healy
5861e77975 docs: v1.3.2 config changelog and accompanying docs updates (#469)
* docs: document config changes

* docs: add IMAGE_GEN_OAI_MODEL documentation
2025-12-25 20:42:50 -05:00
Danny Avila
d55d17c582 🗞️ docs: update changelog for v0.8.2-rc1 with highlights and new features 2025-12-16 20:28:41 -05:00
Dustin Healy
ac70887e5c 🗞️ docs: add v0.8.2-rc1 changelog (#467)
* docs: v0.8.2-rc1 changelog

* fix: swap out old mistake title

* fix: semantic commits take sorting precedence over emojis

* Update changelog for version 0.8.2-rc1

Added new features, bug fixes, and dependency updates for version 0.8.2-rc1.

* Update changelog for v0.8.2-rc1

Updated changelog for version 0.8.2-rc1 with new features, bug fixes, and dependency updates.

* Fix changelog entry for @librechat/agents bump

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
2025-12-16 20:23:21 -05:00
Dustin Healy
e9cabbfb15 📢 docs: add v0.8.1 changelog (#458)
* docs: add v0.8.1 changelog

* chore: reorder model updates

* chore: bump date

* chore: bump date and latest commits

* chore: update release date to 2025/12/11 for v0.8.1

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
2025-12-11 14:47:35 -05:00
Danny Avila
ab364c23c4 📦 chore: Update Packages (#463)
* chore: bump packages

* chore: bump packages

* chore: bump packages

* chore: update package dependencies to latest versions

* chore: update configuration and dependencies for Nextra migration

- Updated TypeScript references in `next-env.d.ts` to align with new Nextra structure.
- Modified `next.config.mjs` to ignore ESLint and TypeScript build errors during the build process.
- Added a new `PACKAGE_UPDATE_SUMMARY.md` documenting package updates and migration details.
- Downgraded Next.js and Nextra versions for compatibility, and updated related dependencies.
- Introduced new `page.tsx` files for dynamic routing and metadata generation in the app directory.
- Added 'use client' directive to multiple components to support client-side rendering.
- Refactored components to remove deprecated Nextra context methods in preparation for App Router.

* chore: update ESLint configuration to use __dirname for tsconfigRootDir and fix lint errors

* chore: update initial statistics for GitHub stars and Docker pulls in Usage component

* chore: refactor clean-cache script to use CommonJS require syntax

* chore: remove redundant ESLint installation step in workflow
2025-12-05 10:53:29 -05:00
Dustin Healy
8218bd0a0e 📒 docs: Add documentation for adding default params via custom params (#454) 2025-12-02 08:11:36 -05:00
Dustin Healy
4646ecc8f7 📰 docs: add v0.8.1-rc2 changelog (#451)
* docs: add v0.8.1-rc2 changelog

* chore: bump release date
2025-11-26 11:45:27 -05:00
Dustin Healy
f1f319a92b 🗞️ docs: Add v0.8.1-rc1 changelog (#450) 2025-11-26 10:13:04 -05:00
Dustin Healy
587d65b87a 📖 docs: Document config changes (v0.8.0-rc1 to v0.8.1-rc1) (#448)
* feat: document new charLimit in memory configuration

* feat: document peoplePicker interface configuration

* feat: document Agent Marketplace configuration

* chore: better description for peoplePicker permissions

* feat: document fileStrategies configuration

* feat: document webSearch's firecrawlVersion addition and scraperType to scraperProvider refactor

* feat: document conversation file import limit env variable CONVERSATION_IMPORT_MAX_FILE_SIZE_BYTES

* feat: document modelSpecs group field configuration

* chore: fix formatting in peoplePicker interface markdown

* feat: add missing .env.example changes

* chore: formatting
2025-11-26 10:12:42 -05:00
Danny Avila
4da57562c7 refactor: remove Code Interpreter API references from FooterMenu and meta files 2025-11-04 13:18:39 -05:00
Danny Avila
042d0eb812 🎉 feat: add Banner component (#435) 2025-11-04 11:50:24 -05:00
Danny Avila
a90b4c4ae3 docs: update changelog for v0.8.0 to include a link to the previous version v0.7.9 2025-10-01 17:47:47 -04:00
Danny Avila
888a9f1e8d docs: add changelog for v1.3.0 release with new features and configuration updates
- Introduced `context` capability for agents endpoint, enabling file uploads in chat.
- Enhanced `fileConfig` with OCR, text parsing, STT separation, and `fileTokenLimit` parameter.
- Added `transactions` object structure for token usage tracking.
- Included `jinaApiUrl` in `webSearch` configuration for custom Jina instances.
- Updated documentation for `fileConfig` to reflect new fields and processing methods.
2025-10-01 17:46:58 -04:00
Danny Avila
405137cc52 chore: update initial statistics for GitHub stars and Docker pulls in Usage component 2025-10-01 17:36:14 -04:00
Danny Avila
7416c3a720 feat: enhance TypeScript support and update configuration files
- Added type definitions for the BlogCard component props.
- Updated tsconfig.json to include new libraries and strict null checks.
- Modified next-env.d.ts to reference additional Next.js navigation types.
2025-10-01 17:36:00 -04:00
Danny Avila
0d99df5306 docs: update changelog for v0.8.0 release highlighting major features, improvements, and updates 2025-10-01 14:47:32 -04:00
Danny Avila
1107a11840 docs: add changelog for v0.8.0 release with new features, refactoring, fixes, and internationalization updates 2025-10-01 14:26:04 -04:00
Danny Avila
4819c54552 fix: correct string interpolation reference in Messages Endpoint 2025-10-01 10:40:18 -04:00
Danny Avila
5701797e44 docs: add changelog for v0.8.0-rc4 release 2025-10-01 10:40:16 -04:00
Dustin Healy
e2f771cea8 📙 docs: Upload as Text (#381)
* 📚 docs: Add OCR, textParsing, and fileTokenLimit configuration documentation (#376)

- Added support for `ocr` and `textParsing` configurations in `fileConfig`, allowing users to specify file types for OCR processing and direct text extraction.
- Introduced `fileTokenLimit` parameter for all endpoints to manage maximum token limits for file processing.

* 📚 docs: Add STT configuration documentation (#380)

- Added `stt` configuration to `fileConfig` for Speech-to-Text audio file processing, including supported MIME types.
- Updated changelog to reflect the addition of STT alongside existing OCR and text parsing configurations.

* 📚 docs: finish fileTokenLimit documentation and update changelog (#382)

* refactor: change `textParsing` to `text`
2025-10-01 10:38:08 -04:00
Danny Avila
1625166492 docs: v0.8.0-rc3 missing documentation (#401)
* docs: Enhance dotenv.mdx with MongoDB connection pool and schema configuration options

- Added new sections for MongoDB connection pool configuration, detailing options like MONGO_MAX_POOL_SIZE and MONGO_MIN_POOL_SIZE.
- Introduced MongoDB schema configuration options, including MONGO_AUTO_INDEX and MONGO_AUTO_CREATE.
- Provided usage examples and explanations for each new option to improve clarity and usability.

* docs: Add Microsoft Graph API integration details for Azure Entra ID

- Introduced new sections in dotenv.mdx and azure.mdx for Microsoft Graph API integration, enhancing permissions and sharing capabilities with people and group search features.
- Added prerequisites and configuration steps for enabling Graph API permissions in Azure app registration.
- Updated token-reuse.mdx to include information on Microsoft Graph API integration when using Azure Entra ID with token reuse.

* docs: Add OPENID_GENERATE_NONCE environment variable to dotenv.mdx

- Introduced the OPENID_GENERATE_NONCE variable, which forces the OpenID client to generate a nonce parameter, addressing requirements from identity providers like AWS Cognito and Authentik.
- Updated documentation to enhance clarity on its usage and importance in OpenID configurations.

* docs: Add SharePoint integration details and configuration instructions

- Introduced a new section in dotenv.mdx for SharePoint integration, detailing environment variables required for enabling the SharePoint file picker.
- Added comprehensive documentation in sharepoint.mdx covering the integration process, prerequisites, and user experience for accessing SharePoint files within LibreChat.
- Updated azure.mdx with additional information on SharePoint permissions needed for Azure app registration.
- Enhanced existing documentation to clarify the setup and usage of SharePoint features, ensuring users can effectively utilize this enterprise capability.

* docs: Add file citation configuration for agents endpoint in v1.2.9

- Introduced new file citation settings (`maxCitations`, `maxCitationsPerFile`, `minRelevanceScore`) to enhance control over citation quality and quantity in agent responses.
- Updated interface configuration to include `fileCitations`, enabling display of file citations during file search functionality.
- Added detailed documentation for the new configuration options in the changelog and relevant sections of the documentation.

* docs: Update fileCitations configuration details in v1.2.9

- Revised the description of the `fileCitations` setting to clarify its role as a global toggle for the `FILE_CITATIONS` permission, affecting all users regardless of individual permissions.
- Enhanced documentation in both the changelog and interface configuration sections to reflect these changes and improve user understanding of citation display behavior during file searches.

* docs: Add USE_REDIS_CLUSTER environment variable to Redis configuration

- Introduced the USE_REDIS_CLUSTER variable in dotenv.mdx to enable Redis cluster mode when using a single URI.
- Updated redis.mdx to include usage instructions for the new variable, enhancing clarity on Redis cluster configurations.

* chore: remove non-existant image reference

* chore: add missing code block language

* docs: Add migration instructions for agent permissions in v0.8.0-rc3+

- Introduced a new section detailing the migration to an ACL-based permission system for agents, including permission levels (OWNER, EDITOR, VIEWER).
- Provided step-by-step commands for running the migration based on different deployment methods (docker-compose, deploy-compose, local development).
- Explained the implications of the migration on existing agents and included a note on prompt permissions migration.
2025-08-27 00:50:36 -04:00
Danny Avila
2c0739e8df docs: Add changelog and release notes for v0.8.0-rc3
- Introduced a new changelog file detailing significant changes, features, and bug fixes in the v0.8.0-rc3 release.
- Created a corresponding page to display the changelog with metadata including date and title.
- Highlights include a granular permissions system, agent marketplace enhancements, and various new features and refactoring efforts.

Full changelog available at: https://github.com/danny-avila/LibreChat/compare/v0.8.0-rc2...v0.8.0-rc3
2025-08-26 12:30:54 -04:00
Marco Beretta
2c19e8968e 🚛 feat: add Daimler Truck logos and Optimize Companies component (#394) 2025-08-14 18:09:06 -04:00
Danny Avila
a28ab06f77 v0.8.0-rc2 (#393)
* v0.8.0-rc2

* 📚 docs: Update Redis configuration details in dotenv.mdx

- Added a new section highlighting Redis performance benefits and horizontal scaling capabilities.
- Updated configuration options for Redis, including new parameters for authentication and connection management.
- Clarified usage notes regarding `USE_REDIS`, `REDIS_URI`, and mutual exclusivity of `REDIS_KEY_PREFIX_VAR` and `REDIS_KEY_PREFIX`.

* 📚 docs: Update memory functionality notes in memory.mdx

- Removed the note indicating that memory only works with agents, clarifying the configuration requirements for memory functionality in LibreChat.

* 📚 docs: Update custom endpoint and default parameters documentation

- Clarified the usage of the `addParams` field in custom endpoints, emphasizing its importance for API-specific options like `max_tokens`.
- Removed default values for `temperature`, `top_p`, `presence_penalty`, and `frequency_penalty` from the default parameters section to streamline the documentation.

* 📚 docs: Enhance memory agent execution notes in memory.mdx

- Added a new callout explaining the execution behavior of the memory agent when memory is enabled.
- Clarified the timing and order of memory updates to ensure a seamless user experience during chat interactions.

* 📚 docs: Add Cloudflare Workers AI configuration documentation

- Introduced a new section detailing the setup and configuration for Cloudflare Workers AI.
- Included required environment variables and example YAML configuration for integration with LibreChat.
- Highlighted compatibility notes and known issues with specific models.

* 📚 docs: Update reasoning effort and add verbosity parameter in model specs

- Changed accepted values for reasoning effort from "None", "Low", "Medium", "High" to "minimal", "low", "medium", "high".
- Updated default value for reasoning effort to reflect API default when not set.
- Introduced a new parameter, verbosity, with accepted values "low", "medium", "high" and provided default value information.
- Updated relevant sections in the URL query documentation to include the new verbosity parameter.

* 📚 docs: Add Auth0 configuration for OpenID Connect

- Introduced a new documentation file for configuring Auth0 as an OpenID Connect provider for LibreChat.
- Updated existing documentation to include Auth0 in the OpenID Connect section and token reuse guidelines.
- Added necessary environment variable details and configuration steps specific to Auth0, including the importance of the `OPENID_AUDIENCE` variable for token validation.

* chore: add bash syntaxing to code blocks

* chore: add alias for cloudflare

* chore: clarification in cloudflare ai docs
2025-08-13 16:21:13 -04:00
Danny Avila
9a5b349c2f docs: Add changelog for v0.8.0-rc1 release (#378) 2025-08-05 13:52:43 -04:00
Danny Avila
9194864fd0 📚 docs: v0.7.9 Changelog (#370)
* 📚 docs: v0.7.9 Changelog

* Update v0.7.9.mdx
2025-07-25 13:32:40 -04:00
Danny Avila
d7ae33a393 📚 docs: Add fileSearch configuration to interface and update changelog for version 1.2.8 (#369)
- Introduced `fileSearch` option to enable or disable the file search button in the chat interface, with a default value of `true`.
- Updated configuration documentation to include `fileSearch` alongside `webSearch`.
- Enhanced changelog to reflect these new features and their implications for the chat interface.
2025-07-25 13:10:03 -04:00
Danny Avila
e3475d8034 📙 docs: missing env. vars, new config fields, bun lockfile, broken links (#366)
* docs: `temporaryChatRetention` to configure retention period for temporary chats to changelog

* docs: `clientImageResize` for automatic client-side image resizing before upload to changelog

* docs: Add rate limiting configurations for login, registration, import conversations, and forking

- Introduced detailed documentation for rate limiting features to prevent abuse, including limits on login attempts, registration, conversation imports, and conversation forking.
- Added configuration options for both IP and user-based limits across these features.
- Updated existing documentation to reflect new rate limiting capabilities and their implications for system security and resource management.

* docs: Fix typos in OpenID on-behalf flow configuration variables

* docs: Add GOOGLE_SERVICE_KEY_FILE environment variable for Vertex AI authentication

- Introduced the `GOOGLE_SERVICE_KEY_FILE` option in the dotenv documentation, allowing users to specify the path to their Google service account JSON key file.
- Updated the Google configuration documentation to include alternative methods for managing service account credentials, enhancing flexibility for users.

* chore: Update bun.lockb to reflect dependency changes

* docs: Update changelog for version 1.2.8 with enhancements to MCP server management and new features

- Enhanced MCP server management with new features including `serverInstructions`, user placeholder variables, `customUserVars`, and centralized `mcpServers` configuration.
- Improved connection status tracking and OAuth support for MCP servers.
- Added support for dynamic user field placeholders in custom endpoint headers.
- Updated `clientImageResize` and `temporaryChatRetention` configurations with detailed descriptions.
- Enhanced web search configuration with comprehensive Firecrawl scraper options.
- Improved Model Specs documentation with updates on parameter support.

* docs: Update OCR configuration documentation for Google Vertex AI support

- Added `vertexai_mistral_ocr` strategy option for OCR configuration, enabling the use of Mistral OCR models on Google Cloud Vertex AI.
- Updated documentation to include methods for providing Google Cloud service account credentials, including file path, URL, base64 encoded JSON, and raw JSON string.
- Enhanced existing sections to reflect the new strategy and its requirements, including automatic extraction of project ID and JWT authentication for secure access.
- Included example configurations for Google Vertex AI deployments in the documentation.

* docs: Enhance GOOGLE_SERVICE_KEY_FILE documentation for base64 encoding option

- Added support for providing the `GOOGLE_SERVICE_KEY_FILE` as a base64 encoded JSON string in the documentation.
- Updated existing sections to clarify the various methods for specifying Google Cloud service account credentials, improving user guidance for Vertex AI authentication.

* docs: Add `REDIS_KEY_PREFIX_VAR` to dotenv documentation for dynamic Redis key prefix

- Introduced `REDIS_KEY_PREFIX_VAR`, an environment variable for specifying a dynamic Redis key prefix, enhancing flexibility for cloud deployments.
- Updated documentation to reflect this new option and its use case, particularly in scenarios involving Kubernetes revision numbers.

* docs: Update changelog and configuration documentation for title generation enhancements

- Added detailed configuration options for title generation across all endpoints, including `titleMethod`, `titlePrompt`, `titlePromptTemplate`, and `titleEndpoint`.
- Updated existing documentation to reflect these new options and their usage, improving clarity on how to customize title generation.
- Included notes on shared endpoint settings applicable to various AI models, enhancing user guidance for configuration.

* fix: broken links

* chore: formatting

* chore: reorganize librechat.yaml sub sections
2025-07-23 12:06:27 -04:00
Dustin Healy
f0f07d24a7 📚 docs: Add firecrawlOptions configuration details to web search documentation (#360)
Co-authored-by: Danny Avila <danny@librechat.ai>
2025-07-22 22:54:17 -04:00
Dustin Healy
b8e656306c 📚 docs: Enhance MCP server management documentation (#365)
- Updated changelog for version 1.2.8 to include enhancements in MCP server management, such as connection status tracking and OAuth support.
- Added detailed documentation on connection status indicators, server initialization processes, and user interface improvements for managing MCP servers.
- Introduced new images and videos to illustrate the updated features and functionalities.
2025-07-22 22:53:00 -04:00
Dustin Healy
dfbd8cbd18 📚 docs: Update Preset Fields and Query Params (#361)
* 📘 docs: Enhance Model Specs documentation with new parameters and default values

- Updated Model Specs documentation to include new parameters: `reasoning_effort`, `reasoning_summary`, `useResponsesApi`, `web_search`, `disableStreaming`, `thinking`, and `thinkingBudget`.
- Added some default values for existing parameters
- Documented changes in changelog

* docs: change note on model params from 'numbers' to 'values' to account for new params that don't have numeric values
2025-07-21 17:41:22 -04:00
Marco Beretta
bc1ba654d0 feat: add companies in Landing (#350)
* feat: add companies in Landing

* feat: add Boston University logos with color variant
2025-07-10 12:09:29 +02:00
Dustin Healy
cb9eaf239b 📚 docs: Add MCP Servers configuration to interface documentation (#337)
* 📚 docs: Add MCP Servers configuration to interface documentation

- Introduced `mcpServers` field in the interface configuration with a placeholder for the MCP server selection dropdown.
- Updated example configurations and added detailed descriptions for the `mcpServers` key and its sub-key `placeholder` in the documentation.

* 📚 docs: Add docs update summary to config_v1.2.8 changelog

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
2025-07-07 12:57:33 -04:00
Dustin Healy
8a4376fc17 📚 docs: Update Custom Endpoint docs with new user placeholder features for headers (#338) 2025-07-07 11:19:54 -04:00
Peter V Cook
35c719e8f2 Update link to 2024 Roadmap to 2025 Roadmap (#343)
* Update link to 2024 Roadmap to 2025 Roadmap

* fix: update Roadmap link to point to 2025 roadmap

---------

Co-authored-by: Marco Beretta <81851188+berry-13@users.noreply.github.com>
2025-07-06 17:26:23 +02:00
Danny Avila
5bec56610f 📘 feat: Update Agents, OCR, and MCP Docs with new Features (#336)
* 📚 docs: Update OCR documentation for clarity and structure

* 📚 docs: Add Model Context Protocol (MCP) documentation and update features

* 📚 docs: Add Model Context Protocol (MCP) section to features documentation

* 📚 docs: Enhance MCP documentation with OAuth authentication details and configuration examples

* 📚 docs: Update MCP documentation with improved configuration examples and OAuth authentication details

* 📚 docs: Update dotenv documentation to reflect new index header constants

* 📚 docs: Revise MCP integration documentation for Agents with clearer instructions and new images

- Updated the steps for adding MCP tools to agents for better clarity and organization.
- Introduced new images to illustrate the MCP tools interface.
- Removed outdated image and improved the overall structure of the documentation.

* 📚 docs: Enhance MCP documentation with custom user variables support

---------

Co-authored-by: Aleš Kůtek <kutekales@gmail.com>
2025-06-19 20:36:29 -04:00
Danny Avila
223d7513fe 📄 docs: Accurate Privacy, Terms of Service, and Cookie Policies (#330)
* 📄 docs: Accurate Privacy, Terms of Service, and Cookie Policies for LibreChat Docs

* 📄 docs: Update last updated dates in Cookie and Privacy Policies to June 13, 2025
2025-06-13 17:18:13 -04:00
Danny Avila
460241640e 📚 docs: Update Config to v1.2.8 and add Azure Mistral OCR Support (#329)
* 📚 docs: Update Config Version to v1.2.8 and add Azure Mistral OCR support

- Updated version numbers in multiple configuration files to reflect the new version 1.2.8.
- Introduced a new `azure_mistral_ocr` strategy option for OCR configuration, enabling the use of Mistral OCR models deployed on Azure AI Foundry.
- Enhanced documentation for OCR configuration to include details on Azure deployment and its requirements.
- Added changelog entries for version 1.2.8, summarizing the new features and updates.

* 📚 docs: Enhance changelog for v1.2.8 with MCP Servers updates

- Added `serverInstructions` to MCP Servers object structure, detailing its role in agent context.
- Introduced new dynamic user field placeholders for enhanced multi-user support, including `{{LIBRECHAT_USER_ID}}` and `{{LIBRECHAT_USER_*}}`.
- Updated documentation links for better navigation and clarity on MCP Servers object structure.

* 📚 docs: Update changelog and OCR documentation for v1.2.8

- Enhanced the changelog for v1.2.8 with additional details on user field placeholders in the MCP Servers object structure.
- Improved OCR documentation by linking strategies to their respective sections for better clarity and navigation.
- Noted the future implementation status of the custom OCR service in the documentation.
2025-06-13 17:13:57 -04:00
Danny Avila
47a5e96d21 🧠 feat: Memories + Documentation Guidelines (#322)
* feat: memories update

* docs: Add LibreChat documentation rules and configuration update guidelines

* docs: Update Node.js version requirements across documentation

- Revised Node.js prerequisites to specify v20.19.0+ (or ^22.12.0 or >= 23.0.0) in README.md, get_started.mdx, npm.mdx, docker_linux.mdx, and nginx.mdx for clarity and compatibility with openid-client v6.

* docs: Add DEBUG_OPENID_REQUESTS environment variable for enhanced OpenID debugging

- Introduced a new environment variable, DEBUG_OPENID_REQUESTS, to enable detailed logging of OpenID request headers for better troubleshooting.
- Updated documentation to include troubleshooting steps for OpenID Connect, emphasizing the use of the new logging feature.

* docs: Update changelog dates for versions v1.2.6 and v1.2.7

* docs: Enhance memory configuration documentation

- Updated the memory configuration section to clarify the default value for the personalize option.
- Changed the provider name from "openai" to "openAI" for consistency.
- Added notes regarding the provider field and valid model parameters.
- Improved examples for memory agent configuration.
2025-06-10 12:54:33 -04:00
Danny Avila
6fa8a6daa2 🔍 docs: Web Search (#309)
* feat: Introduce web search functionality in configuration v1.2.6

- Added `webSearch` configuration to manage web search features, including search providers, scrapers, and rerankers.
- Implemented a toggle for `webSearch` in the interface configuration to control visibility in the chat interface.
- Updated agents configuration to include `web_search` capability, enabling web search for agents by default.
- Created detailed documentation for web search configuration and usage, including API key setup and component descriptions.

* feat: Add web search feature documentation and update configuration

- Introduced a new section for the web search feature in the documentation, detailing its capabilities and configuration options.
- Updated the `_meta.ts` file to include the web search entry.
- Enhanced the web search configuration instructions to emphasize the importance of using environment variable names instead of actual API keys in the YAML file.

* fix: Correct clip-path attribute to clipPath in RossIndex component

* docs: Expand web search feature documentation

- Added detailed information about the web search feature, including environment variable customization options.
- Included a table of required API keys for various search providers and services.
- Emphasized the ability to customize variable names in the `librechat.yaml` configuration file.

* docs: Update web search configuration settings

- Changed default `scraperTimeout` from 30000ms to 7500ms in the documentation.
- Updated `safeSearch` option to reflect new values: 0 (OFF), 1 (MODERATE - default), and 2 (STRICT).
- Enhanced descriptions for both settings to clarify their functionality and defaults.
2025-05-24 10:29:32 -04:00
Danny Avila
3d223aba1f v0.7.8 (#295)
* chore: officially deprecate `endpointsMenu`

* feat: add `chatMenu` option to MCP server configuration for dropdown visibility control

* chore: add missing `timeout` and `initTimeout` options to MCP server configuration

* chore: add Authorization header example to MCP server configuration

* Config v1.2.5

* chore: remove plugins configuration from Azure OpenAI documentation

* feat: add vLLM configuration documentation

* feat: add changelog for LibreChat v0.7.8 and update config date to 2025/5/7
2025-05-08 15:17:02 -04:00