Open3D README

The project's README from github.com/isl-org/Open3D. As one markdown file: README.md.

Open3D: A Modern Library for 3D Data Processing

Homepage | Docs | Quick Start | Compile | Python | C++ | Open3D-ML | Viewer | Contribute | Demo | Forum

Open3D is an open-source library that supports rapid development of software that deals with 3D data. The Open3D frontend exposes a set of carefully selected data structures and algorithms in both C++ and Python. The backend is highly optimized and is set up for parallelization. We welcome contributions from the open-source community.

Ubuntu CI macOS CI Windows CI

Core features of Open3D include:

Here's a brief overview of the different components of Open3D and how they fit together to enable full end to end pipelines:

Open3D_layers

For more, please visit the Open3D documentation.

Also checkout this great introduction to modern 3D data processing that features Open3D:

3D Data Science with Python

3D Data Science with Python by Dr. Florent Poux

From the author:

Throughout the book, I showcase how Open3D enables efficient point cloud processing, mesh manipulation, and 3D visualization through practical examples and code samples. Readers learn to leverage Open3D's powerful capabilities for registration, segmentation, and feature extraction in real-world 3D data science workflows.

Python quick start

Pre-built pip packages support Ubuntu 20.04+, macOS 10.15+ and Windows 10+ (64-bit) with Python 3.10-3.14.

# Install
pip install open3d       # or
pip install open3d-cpu   # Smaller CPU only wheel on x86_64 Linux (v0.17+)

# 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

To get the latest features in Open3D, install the development pip package. To compile Open3D from source, refer to compiling from source.

Release artifacts (Python wheels and C++ binaries) include signed SLSA build-provenance attestations (GitHub Artifact Attestations), aligned with OpenSSF supply-chain guidance. See Getting started — supply chain attestations for verification with the GitHub CLI.

C++ quick start

Checkout the following links to get started with Open3D C++ API

To use Open3D in your C++ project, checkout the following examples

Open3D-Viewer app

Open3D-Viewer is a standalone 3D viewer app available on Debian (Ubuntu), macOS and Windows. Download Open3D Viewer from the release page.

Open3D-ML

Open3D-ML is an extension of Open3D for 3D machine learning tasks. It builds on top of the Open3D core library and extends it with machine learning tools for 3D data processing. To try it out, install Open3D with PyTorch or TensorFlow and check out Open3D-ML.

Communication channels

Citation

Please cite our work if you use Open3D.

@article{Zhou2018,
    author    = {Qian-Yi Zhou and Jaesik Park and Vladlen Koltun},
    title     = {{Open3D}: {A} Modern Library for {3D} Data Processing},
    journal   = {arXiv:1801.09847},
    year      = {2018},
}

Open3D (isl-org/Open3D)

Searching Database…

14.1K ·GitHub
What is this?Open3D is an open-source library for rapid development of software that works with 3D data, offering data structures, processing algorithms, scene reconstruction, surface alignment, visualization and PBR rendering, with 3D machine learning support via PyTorch and TensorFlow.
Is Open3D just a library, or does it include apps too?It is mainly a C++/Python library, but the project also ships a standalone Open3D-Viewer app for browsing 3D data and an Open3D-ML extension that adds 3D machine-learning tools on top of the core library.
How do I get started with Open3D?For Python, install the pre-built pip package; for C++, download the pre-built binary package or compile Open3D from source and link it via CMake in your project.
Do I need both C++ and Python, or just one?Just one: the same Open3D data structures and algorithms are exposed through both a C++ API and a Python API, so you can use whichever fits your project without needing the other.
Are there any catches with the pre-built pip packages?The pip wheels only cover Ubuntu 20.04+, macOS 10.15+ and Windows 10+ with Python 3.10-3.14; anything outside that matrix (or the bleeding-edge dev features) requires compiling Open3D from source.
Which operating systems does Open3D support?Ubuntu 20.04+, macOS 10.15+ and Windows 10+ (64-bit) are supported directly via pip, and the standalone viewer app is also distributed for Debian/Ubuntu, macOS and Windows.
What exactly is Open3D-ML for?Open3D-ML is an extension built on top of the Open3D core library that adds tools specifically for 3D machine learning tasks, and it works alongside PyTorch or TensorFlow.
What is the Open3D-Viewer app, separate from the library?It is a standalone desktop app for browsing and inspecting 3D data, distributed for Debian (Ubuntu), macOS and Windows and downloadable from the GitHub release page.
Can I trust that the downloaded binaries weren't tampered with?Yes, release artifacts (Python wheels and C++ binaries) ship with signed SLSA build-provenance attestations, following OpenSSF supply-chain guidance, which you can verify with the GitHub CLI.
What kinds of 3D tasks does the core library actually cover?Scene reconstruction, surface alignment/registration, mesh and point-cloud processing, and physically based rendering for visualization are all built into the core feature set.
What are similar projects?instant-ngp, taichi, spirula-studio, colmap, Gource, pcl, bgfx, openpose
Creator
isl-org
Size
601.2 MB
Stars
14.1K
Age
9y
Commits · 90 Days