This commit is contained in:
Mendon Kissling 2024-05-01 15:12:58 -04:00
commit 069c9868d6

View file

@ -1,15 +1,18 @@
# Possible Installation Issues # Common Installation Issues
This is a list of possible issues that you may encounter when installing Langflow 1.0 Alpha and how to solve them. 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__'`_ ## _`No module named 'langflow.__main__'`_
TLDR; ### TL;DR
- 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. 1. Run _`python -m langflow run`_ instead of _`langflow run`_.
- If the above doesn't work, run _`python -m pip install langflow --pre -U --force-reinstall`_ to reinstall langflow and its dependencies. 2. If that doesn't work, reinstall Langflow with _`_python -m pip install langflow --pre -U`_.
3. If that doesn't work, reinstall Langflow and its dependencies with _`python -m pip install langflow --pre -U --force-reinstall`_.
When you try to run langflow using the command `langflow run`, you may encounter the following error: ### Details
When you try to run Langflow using the command `langflow run`, you may encounter the following error:
```bash ```bash
> langflow run > langflow run
@ -19,22 +22,27 @@ Traceback (most recent call last):
ModuleNotFoundError: No module named 'langflow.__main__' ModuleNotFoundError: No module named 'langflow.__main__'
``` ```
For this error to occur, two scenarios are possible: There are two possible reasons for this error:
1. You've installed langflow using _`pip install langflow`_ but you already had a previous version of langflow installed in your system. 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. In this case, you might be running the wrong 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`_. To solve this issue, run the correct executable by running _`python -m langflow run`_ instead of _`langflow run`_.
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. If that doesn't work, try uninstalling and reinstalling Langflow with _`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.
## _`Something went wrong running migrations. Please, run 'langflow migration --fix'`_ ## _`Something went wrong running migrations. Please, run 'langflow migration --fix'`_
TLDR; ### TL;DR
- Clear the cache by deleting the contents of the cache folder. - Clear the cache by deleting the contents of the cache folder.
This folder can be found at: This folder can be found at:
- **Linux or WSL2 on Windows**: `home/<username>/.cache/langflow/` - **Linux or WSL2 on Windows**: `home/<username>/.cache/langflow/`
- **MacOS**: `/Users/<username>/Library/Caches/langflow/` - **MacOS**: `/Users/<username>/Library/Caches/langflow/`
If you wish to retain your files, ensure to back them up before clearing the folder. ### Details
This error can occur during Langflow upgrades when the new version can't override `langflow-pre.db` in `.cache/langflow/`. Clearing the cache removes this file but will also erase your settings.
If you wish to retain your files, back them up before clearing the folder.
This error often occurs when upgrading Langflow, the new version can't override `langflow-pre.db` in `.cache/langflow/`. Clearing the cache removes this file but will also erase your settings.