Setup for Linux via pip¶

Python 3.9

Currently, some of our dependencies have issues with the latest versions of Python 3.9.x. For now, our suggestion is to use Python 3.7.x, or 3.8.x versions.

Suggestions

Install MindsDB in a virtual environment when using pip to avoid dependency issues. Make sure your Python>=3.7 and pip>=19.3.

Using the Python `venv` Module¶

Create new virtual environment called mindsdb:
```
python -m venv mindsdb
```
And, activate it:
```
source mindsdb/bin/activate
```
Install MindsDB:
```
pip install mindsdb
```

To verify that mindsdb was installed run:

pip freeze

You should see a list with the names of installed packages included but not limited to:

...
alembic==1.7.7
aniso8601==9.0.1
appdirs==1.4.4
lightgbm==3.3.0
lightwood==22.4.1.0
MindsDB==22.4.5.0
mindsdb-datasources==1.8.2
mindsdb-sql==0.3.3
mindsdb-streams==0.0.5
...

Using Anaconda¶

You will need Anaconda or Conda installed and Python 64-bit version.

Open Anaconda Prompt and create new virtual environment
```
conda create -n mindsdb
```
```
conda activate mindsdb
```
Install mindsdb in recently created virtual environment:
```
pip install mindsdb
```

To verify that Mindsdb was installed run:

conda list

You should see a list with the names of installed packages included but not limited to:

...
alembic==1.7.7
aniso8601==9.0.1
appdirs==1.4.4
lightgbm==3.3.0
lightwood==22.4.1.0
MindsDB==22.4.5.0
mindsdb-datasources==1.8.2
mindsdb-sql==0.3.3
mindsdb-streams==0.0.5
...

Troubleshooting¶

Common Issues¶

Installation fail

Note that Python 64 bit version is required.

Installation fail

If you are using Python 3.9 you may get installation errors. Some of MindsDB's dependencies are not working with Python 3.9, so please downgrade to older versions for now. We are working on this, and Python 3.9 will be supported soon.

IOError: [Errno 28] No space left on device while installing MindsDB

MindsDB requires around 3GB of free disk space to install all of its dependencies.

No module named mindsdb

If you get this error, make sure that your virtual environment(where you installed mindsdb) is activated.

Still Having problems?¶

Don't worry! Try to replicate the issue using the official docker setup, and please create an issue on our Github repository as detailed as possible.

We'll review it and give you a response within a few hours.