diff --git a/docs/docs/getting-started/cli.mdx b/docs/docs/getting-started/cli.mdx
index 050c4ab50..4f7c92983 100644
--- a/docs/docs/getting-started/cli.mdx
+++ b/docs/docs/getting-started/cli.mdx
@@ -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:
diff --git a/docs/docs/index.mdx b/docs/docs/index.mdx
index a00286847..5bfceb2ef 100644
--- a/docs/docs/index.mdx
+++ b/docs/docs/index.mdx
@@ -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"
```
+
+
+ Please, check out our [Possible Installation Issues
+ section](/migration/possible-installation-issues) if you encounter any
+ problems.
+
+
+
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
diff --git a/docs/docs/migration/possible-installation-issues.mdx b/docs/docs/migration/possible-installation-issues.mdx
new file mode 100644
index 000000000..32a2da903
--- /dev/null
+++ b/docs/docs/migration/possible-installation-issues.mdx
@@ -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
+ 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.
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 96a61f68a..18e309f13 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -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",