Release v2.0.18 is based on v2-main branch. With this major update of the new branch v2-main, the Python wrapper is now fully integrated with the open-source Orbbec SDK v2, which makes Python wrapper more flexible and extensible.
Notes: The Python wrapper for the open-source Orbbec SDK v2 is versioned as v2.x.x, while the Python wrapper for the Orbbec SDK v1 is versioned as v1.x.x.
Changelist
- Updated OrbbecSDK to v2.7.6.
- Added support for Gemini 305.
- Added support for Pulsar ME450 and Pulsar SL450 LiDAR devices.
- Added several new samples for device control, recording, playback, confidence, and LiDAR usage.
- Refactored and enhanced several existing samples.
How to install the Package
To make Python more user-friendly, we provide two installation methods: online installation and offline installation.
Windows
We provide both online and offline installation packages for Python versions 3.8 to 3.13.
Follow the windows install documentation to install the SDK online or offline. Then verify the package and run the samples.
Linux
We provide online installation packages for Python versions 3.9 to 3.13 and offline installation packages for Python versions 3.8 to 3.13.
Follow the linux install documentation to install the SDK online or offline. Then verify the package and run the samples.
Documentation
The Orbbec SDK V2 Python Wrapper User Guide provides an overview of the concepts and architecture of Orbbec SDK v2. It includes details on the Python Wrapper installation packages, source compilation, an introduction to commonly used Python Wrapper interfaces, and a FAQ section. Please read it carefully before getting started.
Support Platforms
- Windows 10 or later: x64 architectures
- Linux x64: tested on Ubuntu 20.04, 22.04 and 24.04
- Linux ARM64: tested on NVIDIA Jetson AGX Orin , NVIDIA Jetson Orin NX , NVIDIA Jetson Orin Nano , NVIDIA Jetson AGX Xavier , NVIDIA Jetson Xavier NX , NVIDIA Jetson Thor
Hardware Products Supported by Python SDK
| Products List | Recommended FW Version | Note |
|---|---|---|
| Gemini 305 | 1.0.30 | |
| Astra Mini Pro | 2.0.03 | Version of v2.x.x (major version 2) indicates firmware using the UVC protocol, which is only supported by Orbbec SDK v2. |
| Astra Mini S Pro | 2.0.03 | Version of v2.x.x (major version 2) indicates firmware using the UVC protocol, which is only supported by Orbbec SDK v2. |
| Gemini 435Le | 1.3.6 | |
| Gemini 330 series | 1.6.00 | Gemini 330/330L/335/335L/336/336L/335Lg/335Le |
| Gemini 215 | 1.0.9 | |
| Gemini 210 | 1.0.9 | |
| Gemini 2 | 1.4.98 | |
| Gemini 2 L | 1.5.2 | |
| Femto Bolt | 1.1.3 | |
| Femto Mega | 1.3.1 | |
| Femto Mega I | 2.0.4 | |
| Astra 2 | 2.8.20 | |
| Gemini 345 | 1.9.03 | |
| Gemini 345Lg | 1.9.03 | |
| Pulsar SL450 | 2.2.4.5 | |
| Pulsar ME450 | 1.0.0.6 |
Note:
- If your device is listed above, we recommend using the v2-main branch.
- If your device is not listed, please use the main branch instead.