merge dev on playground

docs/docs/getting-started/cli.mdx

@@ -1,43 +0,0 @@
-# 🖥️ Command Line Interface (CLI)
-
-## Overview
-
-Langflow's Command Line Interface (CLI) is a powerful tool that allows you to interact with the Langflow server from the command line. The CLI provides a wide range of commands to help you shape Langflow to your needs.
-
-Running the CLI without any arguments will display a list of available commands and options.
-
-```bash
-python -m langflow --help
-# or
-python -m langflow
-```
-
-Each option is detailed below:
-
-- `--help`: Displays all available options.
-- `--host`: Defines the host to bind the server to. Can be set using the `LANGFLOW_HOST` environment variable. The default is `127.0.0.1`.
-- `--workers`: Sets the number of worker processes. Can be set using the `LANGFLOW_WORKERS` environment variable. The default is `1`.
-- `--timeout`: Sets the worker timeout in seconds. The default is `60`.
-- `--port`: Sets the port to listen on. Can be set using the `LANGFLOW_PORT` environment variable. The default is `7860`.
-- `--config`: Defines the path to the configuration file. The default is `config.yaml`.
-- `--env-file`: Specifies the path to the .env file containing environment variables. The default is `.env`.
-- `--log-level`: Defines the logging level. Can be set using the `LANGFLOW_LOG_LEVEL` environment variable. The default is `critical`.
-- `--components-path`: Specifies the path to the directory containing custom components. Can be set using the `LANGFLOW_COMPONENTS_PATH` environment variable. The default is `langflow/components`.
-- `--log-file`: Specifies the path to the log file. Can be set using the `LANGFLOW_LOG_FILE` environment variable. The default is `logs/langflow.log`.
-- `--cache`: Select the type of cache to use. Options are `InMemoryCache` and `SQLiteCache`. Can be set using the `LANGFLOW_LANGCHAIN_CACHE` environment variable. The default is `SQLiteCache`.
-- `--dev/--no-dev`: Toggles the development mode. The default is `no-dev`.
-- `--path`: Specifies the path to the frontend directory containing build files. This option is for development purposes only. Can be set using the `LANGFLOW_FRONTEND_PATH` environment variable.
-- `--open-browser/--no-open-browser`: Toggles the option to open the browser after starting the server. Can be set using the `LANGFLOW_OPEN_BROWSER` environment variable. The default is `open-browser`.
-- `--remove-api-keys/--no-remove-api-keys`: Toggles the option to remove API keys from the projects saved in the database. Can be set using the `LANGFLOW_REMOVE_API_KEYS` environment variable. The default is `no-remove-api-keys`.
-- `--install-completion [bash|zsh|fish|powershell|pwsh]`: Installs completion for the specified shell.
-- `--show-completion [bash|zsh|fish|powershell|pwsh]`: Shows completion for the specified shell, allowing you to copy it or customize the installation.
-- `--backend-only`: This parameter, with a default value of `False`, allows running only the backend server without the frontend. It can also be set using the `LANGFLOW_BACKEND_ONLY` environment variable.
-- `--store`: This parameter, with a default value of `True`, enables the store features, use `--no-store` to deactivate it. It can be configured using the `LANGFLOW_STORE` environment variable.
-
-These parameters are important for users who need to customize the behavior of Langflow, especially in development or specialized deployment scenarios.
-
-### Environment Variables
-
-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.

docs/docs/getting-started/huggingface-spaces.mdx

@@ -0,0 +1,27 @@
+import ThemedImage from "@theme/ThemedImage";
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import ZoomableImage from "/src/theme/ZoomableImage.js";
+import Admonition from "@theme/Admonition";
+
+# 🤗 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/Langflow/Langflow?duplicate=true) or [Langflow 1.0 Preview Space](https://huggingface.co/spaces/Langflow/Langflow-Preview?duplicate=true)
+
+Remember to use a Chromium-based browser for the best experience. You'll be presented with the following screen:
+
+<ZoomableImage
+  alt="Docusaurus themed image"
+  sources={{
+    light: "img/duplicate-space.png",
+    dark: "img/duplicate-space.png",
+  }}
+  style={{ width: "100%", margin: "20px auto" }}
+/>
+
+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, set up your API keys 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.

docs/docs/getting-started/install-langflow.mdx

@@ -0,0 +1,77 @@
+import ThemedImage from "@theme/ThemedImage";
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import ZoomableImage from "/src/theme/ZoomableImage.js";
+import Admonition from "@theme/Admonition";
+
+# 📦 Install Langflow
+
+<Admonition type="info">
+  Langflow v1.0 is also available in a [HuggingFace Preview Space](https://huggingface.co/spaces/Langflow/Langflow-Preview?duplicate=true) if you'd rather try it out before installing locally.
+</Admonition>
+
+## Prerequisites
+
+Langflow requires the following programs installed on your system.
+
+* [Python 3.10](https://www.python.org/downloads/release/python-3100/)
+
+* [pip](https://pypi.org/project/pip/) or [pipx](https://pipx.pypa.io/stable/installation/)
+
+## Install Langflow
+
+To install Langflow:
+
+pip:
+```bash
+python -m pip install langflow -U
+```
+
+pipx:
+```bash
+pipx install langflow --python python3.10 --fetch-missing-python
+```
+Pipx can fetch the missing Python version for you with `--fetch-missing-python`, but you can also install the Python version manually.
+
+
+## Install Langflow pre-release
+
+Use `--force-reinstall` to ensure you have the latest version of Langflow and its dependencies.
+
+To install a pre-release version of Langflow:
+
+pip:
+```bash
+python -m pip install langflow --pre --force-reinstall
+```
+
+pipx:
+```bash
+pipx install langflow --python python3.10 --fetch-missing-python --pip-args="--pre --force-reinstall"
+```
+
+## Having a problem?
+
+If you encounter a problem, see [Possible Installation Issues](/migration/possible-installation-issues).
+
+To get help in the Langflow CLI:
+
+```bash
+python -m langflow --help
+```
+
+## ⛓️ Run Langflow
+
+1. To run Langflow, enter the following command.
+```bash
+python -m langflow run
+```
+
+2. Confirm that a local Langflow instance starts by visiting `http://127.0.0.1:7860` in your browser.
+```bash
+│ Welcome to ⛓ Langflow                             │
+│                                                   │
+│ Access http://127.0.0.1:7860                      │
+│ Collaborate, and contribute at our GitHub Repo 🚀 │
+```
+
+3. Continue on to the [Quickstart](./quickstart.mdx).

docs/docs/getting-started/new-to-llms.mdx

@@ -0,0 +1,10 @@
+# 📚 New to LLMs?
+
+Large Language Models, or LLMs, are part of an exciting new world in computing.
+
+We made Langflow for anyone to create with LLMs, and hope you'll feel comfortable installing Langflow and [getting started](./quickstart.mdx).
+
+If you want to learn more about LLMs, prompt engineering, and AI models, Langflow recommends [promptingguide.ai](https://promptingguide.ai), an open-source repository of prompt engineering content maintained by AI experts.
+PromptingGuide offers content for [beginners](https://www.promptingguide.ai/introduction/basics) and [experts](https://www.promptingguide.ai/techniques/cot), as well as the latest [research papers](https://www.promptingguide.ai/papers) and [test results](https://www.promptingguide.ai/research) fueling AI's progress.
+
+Wherever you are on your AI journey, it's helpful to keep Prompting Guide open in a tab.

docs/docs/getting-started/quickstart.mdx

@@ -0,0 +1,119 @@
+import ThemedImage from "@theme/ThemedImage";
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import ZoomableImage from "/src/theme/ZoomableImage.js";
+import ReactPlayer from "react-player";
+import Admonition from "@theme/Admonition";
+
+# ⚡️ Quickstart
+
+This quickstart demonstrates how to install Langflow, run it locally, build a basic prompt flow, and modify that prompt for different outcomes.
+
+## Prerequisites
+
+* [Python 3.10](https://www.python.org/downloads/release/python-3100/)
+
+* [pip](https://pypi.org/project/pip/) or [pipx](https://pipx.pypa.io/stable/installation/)
+
+* [OpenAI API key](https://platform.openai.com)
+
+## Install Langflow
+
+<Admonition type="info">
+  Langflow v1.0 is also available in a [HuggingFace Preview Space](https://huggingface.co/spaces/Langflow/Langflow-Preview?duplicate=true) if you'd rather try it out before installing locally. This quickstart will run there, too.
+</Admonition>
+
+1. To install Langflow, enter the following command in pip or pipx:
+
+pip:
+```bash
+python -m pip install langflow -U
+```
+
+pipx:
+```bash
+pipx install langflow --python python3.10 --fetch-missing-python
+```
+Pipx can fetch the missing Python version for you with `--fetch-missing-python`, but you can also install the Python version manually.
+
+2. Start a local Langflow instance with the Langflow CLI:
+```bash
+langflow run
+```
+
+Or start Langflow with Python:
+```bash
+python -m langflow run
+```
+
+Result:
+```
+│ Welcome to ⛓ Langflow                             │
+│                                                   │
+│ Access http://127.0.0.1:7860                      │
+│ Collaborate, and contribute at our GitHub Repo 🚀 │
+```
+
+3. Go to `http://127.0.0.1:7860` and confirm the Langflow UI is available.
+
+<Admonition type="info">
+    If you encounter a problem, see [Possible Installation Issues](/migration/possible-installation-issues).
+</Admonition>
+
+## Create the basic prompting project
+
+Now that you have Langflow installed and running, let us formally welcome you to Langflow!👋
+
+You will use Langflow's prompt tools to issue prompts to the OpenAI LLM.
+
+Prompts serve as the inputs to a large language model (LLM), acting as the interface between human instructions and computational tasks.
+
+By submitting natural language requests in a prompt to an LLM, you can obtain answers, generate text, and solve problems.
+
+1. From the Langflow dashboard, click **New Project**.
+2. Select **Basic Prompting**.
+3. The **Basic Prompting** flow is created.
+
+<ZoomableImage
+  alt="Docusaurus themed image"
+  sources={{
+    light: "img/quickstart.png",
+    dark: "img/quickstart.png",
+  }}
+  style={{ width: "80%", margin: "20px auto" }}
+/>
+
+This flow allows you to chat with the **OpenAI** component via a **Prompt** component.
+Examine the **Prompt** component. The **Template** field instructs the LLM to `Answer the user as if you were a pirate.`
+This should be interesting...
+
+4. To create an environment variable for the **OpenAI** component, in the **OpenAI API Key** field, click the **Globe** button, and then click **Add New Variable**.
+    1. In the **Variable Name** field, enter `openai_api_key`.
+    2. In the **Value** field, paste your OpenAI API Key (`sk-...`).
+    3. Click **Save Variable**.
+
+## Run the basic prompting flow
+
+1. Click the **Run** button.
+The **Interaction Panel** opens, where you can converse with your bot.
+2. Type a message and press Enter.
+The bot responds in a markedly piratical manner!
+
+## Modify the prompt for a different result
+
+1. To modify your prompt results, in the **Prompt** template, click the **Template** field.
+The **Edit Prompt** window opens.
+2. Change `Answer the user as if you were a pirate` to a different character, perhaps `Answer the user as if you were Harold Abelson.`
+3. Run the basic prompting flow again.
+The response will be markedly different.
+
+## Next steps
+
+Well done! You've built your first prompt in Langflow. 🎉
+
+By adding Langflow components to this prompt, you can build all sorts of interesting flows.
+
+* [Memory chatbot](/starter-projects/memory-chatbot.mdx)
+* [Blog writer](/starter-projects/blog-writer.mdx)
+* [Document QA](/starter-projects/document-qa.mdx)
+
+