Getting started#
Viewer#
Use the Open3D viewer application to visualize 3D data in various formats and
interact with it. You can download the latest stable release app from GitHub
releases. The latest development
version (HEAD of main branch) viewer app is provided here [1]:
Supply chain attestations#
Development artifacts linked on this page—viewer packages, pip wheels, C++ devel archives, and documentation tarballs—are produced by GitHub Actions with signed SLSA build provenance attestations (GitHub Artifact Attestations), consistent with OpenSSF supply-chain recommendations.
After saving a file locally, verify it with the GitHub CLI:
gh attestation verify /path/to/<artifact> -R isl-org/Open3D
Replace /path/to/<artifact> with the wheel, .deb, .zip, .tar.xz,
or docs .tar.gz you downloaded. A successful check confirms the file matches
provenance recorded for this repository.
Python#
Open3D Python packages are distributed via PyPI.
Supported Python versions:
3.10
3.11
3.12
3.13
3.14
Supported operating systems:
Ubuntu 22.04+
macOS 10.15+
Windows 10+ (64-bit)
If you have other Python versions or operating systems, please refer to Build from source and compile Open3D from source.
Pip (PyPI)#
pip install open3d # Standard wheel with CUDA support on x86_64 Linux
pip install open3d-cpu # Smaller CPU only wheel on x86_64 Linux (since v0.17+)
pip install open3d-xpu # Intel GPU wheel on x86_64 Windows and Linux (since v0.20+)
# Preview Windows CUDA wheel (since v0.20+)
pip install https://github.com/isl-org/Open3D/releases/download/v0.20.0/open3d-0.20.0-cp312-cp312-win_amd64.whl # Python 3.10-3.14
Note
The Open3D-ML models and pipelines (open3d.ml.torch, open3d.ml.tf)
need additional Python packages, which are not installed by default. Install
them with the ml extra:
pip install open3d[ml] # or open3d-cpu[ml] / open3d-xpu[ml]
Note
On Windows, open3d is the CPU wheel; pip install open3d-cuda and
pip install open3d-xpu install the CUDA- and SYCL-accelerated wheels
respectively (CUDA runtime dependencies are installed automatically).
Warning
Versions of numpy>=2.0.0 require Open3D>0.18.0 or the latest development
version of Open3D. If you are using an older version of Open3D, downgrade numpy
with
pip install "numpy<2.0.0"
Warning
Please upgrade your pip to a version >=20.3 to install Open3D in Linux,
e.g. with
pip install -U "pip>=20.3"
Note
In general, we recommend using a
virtual environment
or conda environment.
Otherwise, depending on the configurations, you may need pip3 for
Python 3, or the --user option 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, install the development version
(HEAD of main branch) with:
pip install -U -f https://www.open3d.org/docs/latest/dev_wheels.html open3d
See the Development wheels page for a full list of available platform and Python version wheels.
Warning
The development wheels for Linux are named according to PEP600. Please
use pip version >=20.3 to install them. The wheels are not yet fully
PEP600 compliant.
Try it#
# Verify installation
python -c "import open3d as o3d; print(o3d.__version__)"
# Python API
python -c "import open3d as o3d; \
mesh = o3d.geometry.TriangleMesh.create_sphere(); \
mesh.compute_vertex_normals(); \
o3d.visualization.draw(mesh, raw_mode=True)"
# Open3D CLI
open3d example visualization/draw
If these commands work, Open3D is installed successfully.
Troubleshooting:#
If you get an error when importing Open3D, enable detailed Python warnings to help troubleshoot the issue:
python -W default -c "import open3d as o3d"
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 uses some external packages: numpy,
matplotlib, opencv-python.
C++#
To use Open3D in a C++ application, download a binary package archive from
GitHub releases (since v0.15). These binary
package archives contain the Open3D shared library, include headers and GUI /
rendering resources. These are built with all supported features and are
available for the main supported platforms. Also, the latest development version
(HEAD of main branch) binary package archives are provided here [3]:
- Linux (Ubuntu 22.04+ or glibc 2.35+ [4]):
- macOS v10.15+:
- Windows 10+:
If you need a subset of features, or a custom build configuration, please refer to Build from source and compile Open3D from source.
Try it#
Extract the archive and move the contents to a local folder (such as
$HOME/Documents/Open3D_install):
Linux / macOS: Windows:
Open3D_install Open3D_install
├── include ├── bin
│ └── open3d │ ├── Open3D.dll
│ ├── core │ └── resources
│ ├── ... │ ├── brightday_ibl.ktx
│ ├── Open3DConfig.h │ ├── ...
│ ├── Open3D.h │
│ ├── ... ├── CMake
├── lib │ ├── Open3DConfig.cmake
│ ├── cmake │ ├── ...
│ │ └── Open3D ├── include
│ │ ├── ... │ └── open3d
│ ├── pkgconfig │ ├── core
│ │ ├── Open3D.pc │ ├── ...
│ │ ├── ... │ ├── Open3DConfig.h
| | │ ├── Open3D.h
│ ├── libOpen3D.so │ ├── ...
│ ├── open3d_tf_ops.so └── lib
│ └── open3d_torch_ops.so └── Open3D.lib
└── share
└── resources
├── html
│ ├── ...
├── brightday_ibl.ktx
├── ...
Some files may be absent in the case of unsupported functionality. To use Open3D
with your programs through cmake, add -D
Open3D_ROOT=$HOME/Documents/Open3D_install to your CMake configure command
line. See the following example CMake projects for reference:
The C++ code examples in the examples/cpp folder of the repository illustrate
a lot of the functionality available in Open3D and are a good place to start
using Open3D in your projects.