There are a couple of ways to start using Pandas on Ray. Most users will want to
pip, but some users may want to build from the master branch on
the GitHub repo.
Installing with pip¶
Modin can be installed with pip.
pip install modin
Installing from the GitHub master branch¶
If you’d like to try Modin using the most recent updates from the master branch, you can also use pip.
pip install git+https://github.com/modin-project/modin
This will install directly from the repo without you having to clone it! Please be aware that these changes have not made it into a release and may not be completely stable.
For installation on Windows, we recommend using Windows Subsystem for Linux (WSL). This will allow you to use Linux commands on your Windows machine.
One of our dependencies is Ray. Ray is not yet supported natively on Windows, so in order to install it you need to use the WSL if you are on Windows.
Once you’ve installed WSL, you can install Modin in the WSL bash shell just like you would on Linux or Mac:
pip install modin
Once you’ve done this, Modin will be installed. However, it is important to note that you must execute python, ipython and jupyter from the WSL application.
Currently, Modin depends on pandas version 0.23.4. The API of pandas has a tendency to change some with each release, so we pin our current version to the most recent version to take advantage of the newest additions. This also typically means better performance and more correct code.
Modin also depends on Ray. Ray is a task-parallel execution framework for parallelizing new and existing applications with minor code changes. Currently, we depend on the most recent Ray release: 0.5.3.
Building Modin from Source¶
If you’re planning on contributing to Modin, you will need to ensure that you are building Modin from the local repository that you are working off of. Occassionally, there are issues in overlapping Modin installs from pypi and from source. To avoid these issues, we recommend uninstalling Modin before you install from source:
pip uninstall modin
To build from source, you first must clone the repo:
git clone https://github.com/modin-project/modin.git
cd into the
modin directory and use
pip to install:
cd modin pip install -e .