Skip to content

Setup for MacOs 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

  1. Create new virtual environment called mindsdb:

    python -m venv mindsdb
    

    And, activate it:

    source mindsdb/bin/activate
    
  2. Install MindsDB:

    pip install mindsdb
    
  3. 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.

  1. Open Anaconda Prompt and create new virtual environment

    conda create -n mindsdb
    
    conda activate mindsdb
    
  2. Install mindsdb in recently creeated virtual enviroment:

    pip install mindsdb
    
  3. 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

If the installation fails, don't worry; follow the below instruction, which should fix most issues. If none of this works, try using the docker setup and create an issue with the installation errors you got on our Github repository. We'll try to review it and give you a response within a few hours.

Installation fail

Note that Python 64 bit version is required.

Installation fails because of system dependencies

Try installing MindsDB with Anaconda, and run the installation from the anaconda prompt.

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.

numpy.distutils.system_info.NotFoundError: No lapack/blas resources found. Note: Accelerate is no longer supported.

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.