Add possible installation issues page (#1627)

* Update Langflow CLI installation and usage instructions
This commit is contained in:
Gabriel Luiz Freitas Almeida 2024-04-05 17:04:25 -03:00 committed by GitHub
commit 606d37bab2
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 40 additions and 5 deletions

View file

@ -1,6 +1,5 @@
# 🖥️ 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.
@ -8,9 +7,9 @@ Langflow's Command Line Interface (CLI) is a powerful tool that allows you to in
Running the CLI without any arguments will display a list of available commands and options.
```bash
langflow --help
python -m langflow --help
# or
langflow
python -m langflow
```
Each option is detailed below:

View file

@ -45,6 +45,14 @@ python -m pip install langflow --pre --force-reinstall
pipx install langflow --python python3.10 --fetch-missing-python --pip-args="--pre --force-reinstall"
```
<Admonition type="tip">
<p>
Please, check out our [Possible Installation Issues
section](/migration/possible-installation-issues) if you encounter any
problems.
</p>
</Admonition>
We recommend using --force-reinstall to ensure you have the latest version of Langflow and its dependencies.
### ⛓️ Running Langflow
@ -52,7 +60,7 @@ We recommend using --force-reinstall to ensure you have the latest version of La
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
python -m langflow run # or langflow --help
```
#### 🤗 HuggingFace Spaces
@ -93,7 +101,7 @@ langflow run [OPTIONS]
Find more information about the available options by running:
```bash
langflow --help
python -m langflow --help
```
## Find out more about 1.0

View file

@ -0,0 +1,27 @@
# Possible Installation Issues
This is a list of possible issues that you may encounter when installing Langflow 1.0 Alpha and how to solve them.
## No module named 'langflow.**main**'
TLDR;
- Run _`python -m langflow run`_ instead of _`langflow run`_. If that doesn't work, run _`_python -m pip install langflow --pre -U`_ to reinstall langflow.
- If the above doesn't work, run _`python -m pip install langflow --pre -U --force-reinstall`_ to reinstall langflow and its dependencies.
When you try to run langflow using the command `langflow run`, you may encounter the following error:
```bash
> langflow run
Traceback (most recent call last):
File ".../langflow", line 5, in <module>
from langflow.__main__ import main
ModuleNotFoundError: No module named 'langflow.__main__'
```
For this error to occur, two scenarios are possible:
1. You've installed langflow using _`pip install langflow`_ but you already had a previous version of langflow installed in your system.
In this case, you might not be running the correct executable.
To solve this issue, you can run the correct executable by running _`python -m langflow run`_ instead of _`langflow run`_ and if that doesn't work, you can try uninstalling langflow and reinstalling it using _`python -m pip install langflow --pre -U`_.
2. Some version conflicts might have occurred during the installation process. Run _`python -m pip install langflow --pre -U --force-reinstall`_ to reinstall langflow and its dependencies.

View file

@ -29,6 +29,7 @@ module.exports = {
label: " Migration Guides",
collapsed: false,
items: [
"migration/possible-installation-issues",
// "migration/flow-of-data",
"migration/inputs-and-outputs",
// "migration/supported-frameworks",