Merge branch 'zustand/io/migration' of personal:logspace-ai/langflow into zustand/io/migration

docs/docs/getting-started/first-steps.mdx

@@ -1,28 +1,52 @@
-# ⛓️ Running Langflow
+# First steps
 
-Langflow can be run in a variety of ways, including using the command-line interface (CLI) or HuggingFace Spaces.
+## Installation
+
+Make sure you have **Python 3.10** installed on your system.
+
+You can install **Langflow** with [pipx](https://pipx.pypa.io/stable/installation/) or with pip.
+
+Pipx can fetch the missing Python version for you, but you can also install it manually.
 
 ```bash
-python -m langflow run
+pipx install langflow --python python3.10 --fetch-missing-python
+# or
+pip install langflow -U
 ```
 
-or
+Or you can install a pre-release version using:
+
+```bash
+pipx install langflow --python python3.10 --fetch-missing-python --pip-args="--pre"
+# or
+pip install langflow --pre -U
+```
+
+##⛓️ Running Langflow
+
+Langflow can be run in a variety of ways, including using the command-line interface (CLI) or HuggingFace Spaces.
 
 ```bash
 langflow run # or langflow --help
 ```
 
-
 ### 🤗 HuggingFace Spaces
 
-Check out our [guide](./hugging-face-spaces) on how to get your Langflow instance running on HuggingFace Spaces.
+Hugging Face provides a great alternative for running Langflow in their Spaces environment. This means you can run Langflow without any local installation required.
+
+The first step is to go to the [Langflow Space](https://huggingface.co/spaces/Logspace/Langflow?duplicate=true). Remember to use a Chromium-based browser for the best experience. You’ll be presented with the following screen:
+From here, just name your Space, define the visibility (Public or Private), and click on `Duplicate Space` to start the installation process. When that is done, you’ll be redirected to the Space’s main page to start using Langflow right away!
+
+Once you get Langflow running, click on New Project in the top right corner of the screen. Langflow provides a range of example flows to help you get started.
+
+To quickly try one of them, open a starter example and click ⚡ Run, on the bottom right corner of the canvas. This will open up Langflow’s Interaction Panel with the chat console, text inputs, and outputs.
 
 
-# 🖥️ Command Line Interface (CLI)
+### 🖥️ Command Line Interface (CLI)
 
 Langflow provides a command-line interface (CLI) for easy management and configuration.
 
-## Usage
+#### Usage
 
 You can run the Langflow using the following command:
 
@@ -58,4 +82,5 @@ These parameters are important for users who need to customize the behavior of L
 
 You can configure many of the CLI options using environment variables. These can be exported in your operating system or added to a `.env` file and loaded using the `--env-file` option.
 
-A sample `.env` file named `.env.example` is included with the project. Copy this file to a new file named `.env` and replace the example values with your actual settings. If you're setting values in both your OS and the `.env` file, the `.env` settings will take precedence.
+A sample `.env` file named `.env.example` is included with the project. Copy this file to a new file named `.env` and replace the example values with your actual settings. If you're setting values in both your OS and the `.env` file, the `.env` settings will take precedence.
+

docs/docs/getting-started/installation.mdx

@@ -1,17 +0,0 @@
-# 📦 How to install?
-
-## Installation
-
-Make sure you have **Python 3.10** installed on your system.
-
-You can install **Langflow** using pip:
-
-```bash
-pip install langflow -U
-```
-
-Or you can install a pre-release version using:
-
-```bash
-pip install langflow --pre -U
-```

docs/docs/whats-new/migrating-to-one-point-zero.mdx

@@ -10,7 +10,7 @@ We have a special channel in our Discord server dedicated to Langflow 1.0 migrat
 ## TLDR;
 
 - Inputs and Outputs of Components have changed
-- The composition model has been replaced with a flow of data
+- We've surfaced steps that were previously run in the background
 - Continued support for LangChain and new support for multiple frameworks
 - Redesigned sidebar and customizable interaction panel
 - New Native Categories and Components
@@ -32,11 +32,11 @@ Langflow 1.0 introduces adds the concept of Inputs and Outputs to flows, allowin
 
 [Learn more about Inputs and Outputs of Components](../migration/inputs-and-outputs)
 
-## From Composition to Freedom
+## To Compose or Not to Compose: the choice is yours
 
-Even though composition is still possible in Langflow 1.0, the new standard is getting data moving through the flow. This allows for more flexibility and control over the data flow in your projects. Check out how to use this in new and existing projects.
+Even though composition is still possible in Langflow 1.0, the new standard is getting data moving through the flow. This allows for more flexibility and control over the data flow in your projects.
 
-[Learn more about the Flow of Data](../migration/flow-of-data)
+We will create guides on how to interweave LangChain components with our Core components soon.
 
 ## Continued Support for LangChain and Multiple Frameworks
 

docs/sidebars.js

@@ -6,8 +6,8 @@ module.exports = {
       collapsed: false,
       items: [
         "index",
-        "getting-started/installation",
-        "getting-started/usage",
+        "getting-started/first-steps",
+        "getting-started/cli",
         "getting-started/hugging-face-spaces",
         "getting-started/creating-flows",
       ],

src/backend/base/langflow/components/helpers/SplitText.py

@@ -9,7 +9,7 @@ from langchain_core.documents import Document
 from langflow.interface.custom.custom_component import CustomComponent
 from langflow.schema import Record
 from langflow.field_typing import Text
-from langflow.utils.util import build_loader_repr_from_records, unescape_string
+from langflow.utils.util import unescape_string
 
 
 class SplitTextComponent(CustomComponent):

src/backend/base/langflow/components/vectorsearch/AstraDBSearch.py

@@ -137,4 +137,12 @@ class AstraDBSearchComponent(LCVectorStoreComponent):
             metadata_indexing_exclude=metadata_indexing_exclude,
             collection_indexing_policy=collection_indexing_policy,
         )
-        return self.search_with_vector_store(input_value, search_type, vector_store, k=number_of_results)
+        try:
+            return self.search_with_vector_store(input_value, search_type, vector_store, k=number_of_results)
+        except KeyError as e:
+            if "content" in str(e):
+                raise ValueError(
+                    "You should ingest data through Langflow (or LangChain) to query it in Langflow. Your collection does not contain a field name 'content'."
+                )
+            else:
+                raise e

src/backend/base/langflow/graph/graph/base.py

@@ -1,7 +1,7 @@
 import asyncio
 from collections import defaultdict, deque
 from itertools import chain
-from typing import TYPE_CHECKING, Callable, Coroutine, Dict, Generator, List, Literal, Optional, Type, Union
+from typing import TYPE_CHECKING, Callable, Coroutine, Dict, Generator, List, Optional, Type, Union
 
 from loguru import logger