Setup for MacOS via pip¶

Before You Start¶

There are some points that you should consider before jumping into the installation. Please have a look at them below.

Pip and Python Versions¶

Due to some of our dependencies having issues with the latest versions of Python 3.9.x, we suggest using Python 3.7.x or 3.8.x versions for now. We are working on Python 3.9.x to be supported soon.

To successfully install MindsDB, use Python 64-bit version. Also, make sure that Python >= 3.7 and pip >= 19.3. You can check the pip and python versions by running the pip --version and python --version commands.

Please note that depending on your environment and installed pip and python packages, you might have to use pip3 instead of pip or python3.x instead of py. For example, pip3 install mindsdb instead of pip install mindsdb.

How to Avoid Dependency Issues¶

Install MindsDB in a virtual environment using pip to avoid dependency issues.

Or you could try to install MindsDB with Anaconda and run the installation from the Anaconda prompt.

How to Avoid Common Errors¶

MindsDB requires around 3 GB of free disk space to install all of its dependencies. Make sure to allocate min. 3 GB of disk space to avoid the IOError: [Errno 28] No space left on device while installing MindsDB error.

Before anything, activate your virtual environment where your MindsDB is installed. It is to avoid the No module named mindsdb error.

The numpy.distutils.system_info.NotFoundError: No lapack/blas resources found. Note: Accelerate is no longer supported. error might be caused by some dependencies not working with Python 3.9 version. For now, please use Python 3.7.x or Python 3.8.x, as mentioned before.

Using the Python `venv` Module¶

Create a new virtual environment called mindsdb:
```
python -m venv mindsdb
```
Now, activate it:
```
source mindsdb/bin/activate
```
Once inside the virtual environment, run the command below to mitigate the dependency issues:
```
pip install --upgrade pip setuptools wheel
```
Install MindsDB:
```
pip install mindsdb
```

Verify MindsDB installation:

pip freeze

You should see a list of installed packages including but not limited to the following:

...
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¶

Here, you need either Anaconda or Conda installed on your machine.

Open Anaconda prompt and create a new virtual environment:
```
conda create -n mindsdb
```
Now, activate it:
```
conda activate mindsdb
```
Once inside the virtual environment, run the command below to mitigate the dependency issues:
```
pip install --upgrade pip setuptools wheel
```
Install MindsDB:
```
pip install mindsdb
```

Verify MindsDB installation:

conda list

You should see a list of installed packages including but not limited to the following:

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

Further Issues?¶

You can try to replicate your issue using the Docker setup.

Also, please create an issue with detailed description in the MindsDB GitHub repository so we can help you. Usually, we review issues and respond within a few hours.

What's next?

We recommend you follow one of our tutorials or learn more about the MindsDB Database.