Add Langflow CLI and first steps documentation

This commit is contained in:
Gabriel Luiz Freitas Almeida 2024-04-02 19:14:08 -03:00
commit 4e3690cedc
5 changed files with 40 additions and 32 deletions

View file

View file

@ -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. Youll 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, youll be redirected to the Spaces 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 Langflows 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.

View file

@ -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
```

View file

@ -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

View file

@ -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",
],