diff --git a/docs/docs/Components/bundles-nvidia.mdx b/docs/docs/Components/bundles-nvidia.mdx index cbc5369f7..af16b55a9 100644 --- a/docs/docs/Components/bundles-nvidia.mdx +++ b/docs/docs/Components/bundles-nvidia.mdx @@ -44,6 +44,12 @@ For more information about using embedding model components in flows, see [**Emb | temperature | Float | Input parameter. The model temperature for embedding generation. Default: `0.1`. | | embeddings | Embeddings | Output parameter. An `NVIDIAEmbeddings` instance for generating embeddings. | +:::tip Tokenization considerations +Be aware of your embedding model's chunk size limit. +Tokenization errors can occur if your text chunks are too large. +For more information, see [Tokenization errors due to chunk size](/components-processing#chunk-size). +::: + ## NVIDIA Rerank This component finds and reranks documents using the NVIDIA API. @@ -53,7 +59,7 @@ This component finds and reranks documents using the NVIDIA API. This component uses the NVIDIA `nv-ingest` microservice for data ingestion, processing, and extraction of text files. For more information, see [Integrate NVIDIA Retriever Extraction with Langflow](/integrations-nvidia-ingest). -## NVIDIA System-Assist +## NVIDIA G-Assist This component requires a specific system environment. For information about this component, see [Integrate NVIDIA G-Assist with Langflow](/integrations-nvidia-g-assist). \ No newline at end of file diff --git a/docs/docs/Components/components-processing.mdx b/docs/docs/Components/components-processing.mdx index 617a843f3..b6e76a9b4 100644 --- a/docs/docs/Components/components-processing.mdx +++ b/docs/docs/Components/components-processing.mdx @@ -755,11 +755,18 @@ You can toggle parameters through the **Inspect output** on the component in the visual editor. +## Access Langflow Desktop logs {#desktop-logs} + +If you encounter issues with Langflow Desktop, you might need to access startup logs for debugging. +Follow the steps for your operating system. + + + + +1. Open Terminal and run: + ```bash + cd ~/Library/Logs/com.Langflow + ``` + +2. To open the folder and view the log files, run the command: + ```bash + open . + ``` + +3. Locate the `langflow.log` file. + + + +1. Open the Command Prompt (CMD), and then run the following command: + ```cmd + cd %LOCALAPPDATA%\com.langflow\logs + ``` + +2. To open the folder and view the log files, run the command: + ```cmd + start . + ``` + +3. Locate the `langflow.log` file. + + + +You can use the log file to investigate the issue on your own, add context to a [GitHub Issue](/contributing-github-issues), or send it to [support](/luna-for-langflow) for debugging assistance. + +The log file is only created when Langflow Desktop runs. If you don't see a log file, try starting Langflow Desktop first, then check for the log file. ## See also * [Memory management options](/memory) diff --git a/docs/docs/Get-Started/get-started-installation.mdx b/docs/docs/Get-Started/get-started-installation.mdx index 917a4ed13..198d5387a 100644 --- a/docs/docs/Get-Started/get-started-installation.mdx +++ b/docs/docs/Get-Started/get-started-installation.mdx @@ -26,6 +26,8 @@ However, some features aren't available for Langflow Desktop, such as the **Shar +Langflow Desktop requires macOS 13 or later. + 1. Navigate to [Langflow Desktop](https://www.langflow.org/desktop). 2. Click **Download Langflow**, enter your contact information, and then click **Download**. 3. Mount and install the Langflow application. diff --git a/docs/docs/Integrations/Nvidia/integrations-nvidia-ingest.mdx b/docs/docs/Integrations/Nvidia/integrations-nvidia-ingest.mdx index 98d025a2e..1db9d0a7e 100644 --- a/docs/docs/Integrations/Nvidia/integrations-nvidia-ingest.mdx +++ b/docs/docs/Integrations/Nvidia/integrations-nvidia-ingest.mdx @@ -78,7 +78,7 @@ For more information, see the [NV-Ingest documentation](https://nvidia.github.io | extract_infographics | Extract Infographics | Extract infographics from document. Default: false. | | text_depth | Text Depth | The level at which text is extracted. Options: 'document', 'page', 'block', 'line', 'span'. Default: `page`. | | split_text | Split Text | Split text into smaller chunks. Default: true. | -| chunk_size | Chunk Size | The number of tokens per chunk. Default: `500`. | +| chunk_size | Chunk Size | The number of tokens per chunk. Default: `500`. Make sure the chunk size is compatible with your embedding model. For more information, see [Tokenization errors due to chunk size](/components-processing#chunk-size). | | chunk_overlap | Chunk Overlap | Number of tokens to overlap from previous chunk. Default: `150`. | | filter_images | Filter Images | Filter images (see advanced options for filtering criteria). Default: false. | | min_image_size | Minimum Image Size Filter | Minimum image width/length in pixels. Default: `128`. | diff --git a/docs/docs/Support/release-notes.mdx b/docs/docs/Support/release-notes.mdx index 8faed6160..f75f7e168 100644 --- a/docs/docs/Support/release-notes.mdx +++ b/docs/docs/Support/release-notes.mdx @@ -107,7 +107,7 @@ For all changes, see the [Changelog](https://github.com/langflow-ai/langflow/rel - Enhanced file and flow management system with improved bulk capabilities. - Added the **BigQuery** component - Added the **Twelve Labs** bundle -- Added the **NVIDIA System Assistant** component +- Added the **NVIDIA G-Assist** component ### Deprecations diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 33e60f3b8..86084eb7c 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -124,6 +124,21 @@ There are two possible reasons for this error: Environment variables set in your terminal aren't automatically available to GUI-based applications like Langflow Desktop when launched through the Finder or the Start Menu. To set environment variables for Langflow Desktop, see [Set environment variables for Langflow Desktop](/environment-variables#set-environment-variables-for-langflow-desktop). +### Access Langflow Desktop startup logs + +If you encounter issues with Langflow Desktop, you might need to [access Langflow Desktop startup logs](/logging#desktop-logs) for debugging. + +### User not found or inactive when running multiple flows + +When running multiple local Langflow OSS instances on different ports, such as `localhost:7860` and `localhost:7861`, you might see authentication errors in the logs. +For example: + +```text +[07/22/25 10:57:07] INFO 2025-07-22 10:57:07 - INFO - utils - User not found or inactive. +``` + +To resolve this error, use separate browser instances or browser profiles to access each Langflow instance. + ### Package is not installed In Langflow OSS, you can follow the error message's instructions to install the missing dependency. @@ -153,6 +168,15 @@ Clearing the cache erases your settings. If you want to retain your settings files, create a backup of those files before clearing the cache folder. ::: +### Langflow Desktop says it is running the latest version, but it is actually behind + +If you are running Langflow Desktop version 1.4.2 or earlier, the UI might incorrectly report that you are on the latest version when a newer version is available. + +This happens because the automatic update feature in the UI was introduced in version 1.4.2. +Earlier versions can't automatically detect or apply updates. + +To resolve this issue, uninstall Langflow Desktop, and then [download and install the latest version of Langflow Desktop](https://langflow.org/desktop). + ## Langflow uninstall issues The following issues can occur when uninstalling Langflow. @@ -174,6 +198,11 @@ To fully remove a Langflow Desktop macOS installation, you must also delete `~/. - [Use MCP Inspector to test and debug flows](/mcp-server#test-and-debug-flows) - [Troubleshooting MCP server](/mcp-server#troubleshooting-mcp-server) +## Token length limit errors in Embedding Model components + +Token length errors can happen if your chunking strategy doesn't align with your embedding model's tokenization limits. +For more information, see [Tokenization errors due to chunk size](/components-processing#chunk-size). + ## Custom components and integrations issues For troubleshooting advice for a third-party integration, see the information about that integration in the Langflow documentation and the provider's documentation.