pyorbbecsdk Releases

v2.0.18

2026-02-27 18:11

**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](https://github.com/orbbec/OrbbecSDK_v2),  which makes Python wrapper more flexible and extensible.

> Notes: The Python wrapper for the open-source [Orbbec SDK v2](https://github.com/orbbec/OrbbecSDK_v2) is versioned as v2.x.x, while the Python wrapper for the [Orbbec SDK v1](https://github.com/orbbec/OrbbecSDK) 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](
https://orbbec.github.io/pyorbbecsdk/source/2_installation/install_the_package.html#windows) 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](
https://orbbec.github.io/pyorbbecsdk/source/2_installation/install_the_package.html#linux) to install the SDK online or offline. Then verify the package and run the samples.

## Documentation

The [Orbbec SDK V2 Python Wrapper User Guide](https://orbbec.github.io/pyorbbecsdk/index.html) 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](https://doc.orbbec.com/documentation/Gemini%20305%20Documentation/Firmware%20Release%20of%20Gemini%20305)                    |                                              |
| Astra Mini Pro                        | [2.0.03](https://github.com/orbbec/OrbbecFirmware/releases/tag/Astra-Mini-Pro)                      | **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](https://github.com/orbbec/OrbbecFirmware/releases/tag/Astra-Mini-S-Pro)                      | **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](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemin435Le-Firmware)                      |                                              |
| Gemini 330   series     | [1.6.00](https://www.orbbec.com/docs/g330-firmware-release/?_gl=1)                      |   Gemini 330/330L/335/335L/336/336L/335Lg/335Le            |   
| Gemini 215                 | [1.0.9](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini215-Firmware)                         |                                              |
| Gemini 210                 | [1.0.9](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini210-Firmware)                         |                                              |
| Gemini 2                     | [1.4.98](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini2-Firmware)                       |                                              |
| Gemini 2 L                  | [1.5.2](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini2L-Firmware)                       |                                              |
| Femto Bolt                  | [1.1.3](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Bolt-Firmware)                        |                                            |
| Femto Mega               | [1.3.1](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-Firmware)                        |                                               |
| Femto Mega I             | [2.0.4](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-I-Firmware)                       |     
| Astra 2                        | [2.8.20](https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Astra2_Release_2.8.20.zip)                      |                                               |
| 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.

Last committed message: Update version to v2.0.18

v2.0.15

1a93815

2025-10-25 13:36

Release v2.0.15

The Release v2.0.15 is base on v2-main branch, With the major update of the new branch v2-main, python wrapper is connected to the open source version of [Orbbec SDK v2](https://github.com/orbbec/OrbbecSDK_v2),  which will make python wrapper more flexible and extensible.

- Notes: The Python wrapper for the open-source [Orbbec SDK v2](https://github.com/orbbec/OrbbecSDK_v2) is versioned as v2.x.x, while the python wrapper for the [Orbbec SDK v1](https://github.com/orbbec/OrbbecSDK) is versioned as v1.x.x.

# Changelist
- Updated OrbbecSDK to v2.5.5.
- Added samples for laser_interleave.py and forceip.py.
- Added an API to enable device heartbeat.
- Added an API to configure and query network device IP addresses.
- Added compatibility with numpy>=2.0.0.
- Added support for installing pyorbbecsdk2 via **PyPI**.

# How to Use install 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](
https://orbbec.github.io/pyorbbecsdk/source/2_installation/install_the_package.html#windows) to install the SDK online or offline. Then verify the package and run the sample.

## Linux
We provide online installation packages for Python versions **3.9** to **3.13** and provide offline installation packages for Python versions **3.8** to **3.13**.
Follow the [linux install documentation](
https://orbbec.github.io/pyorbbecsdk/source/2_installation/install_the_package.html#linux) to install the SDK online or offline. Then verify the package and run the sample.

# Documentation

Refer to [Orbbec SDK V2 Python Wrapper User Guide](https://orbbec.github.io/pyorbbecsdk/index.html) for detailed documentation.

# Support Platforms

- Windows: Windows 10 (x64)
- Linux: 18.04/20.04/22.04/24.04 (x64)
- Arm64: Ubuntu18.04/20.04/22.04

## Supported Devices and Recommended Firmware Version
| **Products List** | **Recommended FW Version** |       Note                      |
|-------------------|------------------------------|--------------------------|
| Astra Mini Pro                        | [2.0.03](https://github.com/orbbec/OrbbecFirmware/releases/tag/Astra-Mini-Pro)                      | **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](https://github.com/orbbec/OrbbecFirmware/releases/tag/Astra-Mini-S-Pro)                      | **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](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemin435Le-Firmware)                      |                                              |
| Gemini 330   series     | [1.6.00](https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.6.00.zip)                      |   Gemini 330/330L/335/335L/336/336L/335Lg/335Le            |   
| Gemini 215                 | [1.0.9](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini215-Firmware)                         |                                              |
| Gemini 210                 | [1.0.9](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini210-Firmware)                         |                                              |
| Gemini 2                     | [1.4.98](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini2-Firmware)                       |                                              |
| Gemini 2 L                  | [1.5.2](https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini2L-Firmware)                       |                                              |
| Femto Bolt                  | [1.1.2](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Bolt-Firmware)                        |                                             |
| Femto Mega               | [1.3.1](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-Firmware)                        |                                               |
| Femto Mega I             | [2.0.4](https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-I-Firmware)                       |     
| Astra 2                        | [2.8.20](https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Astra2_Release_2.8.20.zip)                      |                                               |

- If your device is included in this supported list, we recommend using the v2-main branch. If not, you can use the main branch instead.

Last committed message: update version to v2.0.15