Getting started

Installing from PyPI or Conda

Open3D Python packages are distributed via PyPI and Conda.

Supported Python versions:

  • 3.6

  • 3.7

  • 3.8

Supported operating systems:

  • Ubuntu 18.04+

  • macOS 10.14+

  • Windows 10 (64-bit)

If you have other Python versions (e.g. Python 2) or operating systems, please refer to Build from source and compile Open3D from source.

Pip (PyPI)

pip install open3d

Note

In general, we recommend using a virtual environment for containerization. Otherwise, depending on the configurations, pip3 may be needed for Python 3, or the --user option may need to be used to avoid permission issues. For example:

pip3 install open3d
# or
pip install --user open3d
# or
python3 -m pip install --user open3d

Development version (pip)

To test the latest features in Open3D, download and install the development version (HEAD of master branch):

Linux

Python 3.6 Python 3.7 Python 3.8

MacOS

Python 3.6 Python 3.7 Python 3.8

Windows

Python 3.6 Python 3.7 Python 3.8

Please use these links from the latest version of this page only. For example, to install the latest development version on Linux for Python 3.8:

pip install --user --pre https://storage.googleapis.com/open3d-releases-master/python-wheels/open3d-0.12.0-cp38-cp38-linux_x86_64.whl

Conda

conda install -c open3d-admin open3d

Note

Open3D prebuilt binaries for Conda (Anaconda/Miniconda) can be found at open3d. Currently, the open3d package is distributed under the open3d-admin channel. To setup Conda, please see the official documentation.

Try it

Now, try importing Open3D.

python -c "import open3d as o3d"

If this works, congratulations, now Open3D has been successfully installed!

Running Open3D tutorials

A complete set of Python tutorials and testing data will also be copied to demonstrate the usage of Open3D Python interface. See examples/python for all Python examples.

Note

Open3D’s Python tutorial utilizes some external packages: numpy, matplotlib, opencv-python. OpenCV is only used for reconstruction system. Please read util/install-deps-python.sh for installing these packages.