Installation
MMF has been tested on Python 3.7+ and PyTorch 1.6. We recommend using a conda environment to install MMF.
Creating a conda environment [Optional]
Assuming you have conda installed, run:
conda create -n mmf python=3.7
conda activate mmf
Install from source [Recommended]
To install from source do:
git clone https://github.com/facebookresearch/mmf.git
cd mmf
pip install --editable .
Install using pip
MMF can be installed using pip with the following command:
pip install --upgrade --pre mmf
Use this if:
- You are using MMF as a library and not developing inside MMF. Take a look at the extending MMF tutorial.
- You want easy installation and don't care about up-to-date features. Note that pip packages are always outdated relative to installing from source.
Alternatively, to install latest MMF version from GitHub using pip, use
pip install git+https://github.com/facebookresearch/mmf.git
Windows
If you are on Windows, run the pip install commands with an extra argument like:
pip install -f https://download.pytorch.org/whl/torch_stable.html --editable .
Running tests [Optional]
MMF uses pytest for testing. To verify everything and run tests at your end do:
pytest ./tests/
Contributing to MMF
We welcome all contributions to MMF. Have a look at our contributing guidelines to get started.