pyorbbecsdk

Python Bindings for Orbbec SDK v2.x
The official Python wrapper enabling developers to interface with Orbbec RGB-D cameras (Gemini, Femto, Astra series) through a clean, Pythonic API backed by native C++ performance via pybind11.

Documentation · PyPI Package · Community · OrbbecSDK v2 · Gitee Mirror

Branch note: This is the v2-main branch (SDK v2.x). For the legacy v1.x branch, see main. The differences between SDK v1.x and v2.x are described in the OrbbecSDK_v2 README.

Overview
Supported Devices
Why pyorbbecsdk?
Getting started
Samples
Supported platforms
Automated Firmware Update
FAQ
Community
Changelog
License

Overview

AMR Grocery Delivery	Body Health Tracking	3D Face Payment

Supported Devices

Important:

Most new devices come with compatible firmware pre-installed and work out-of-the-box.

Starting from October 2025 (Orbbec SDK v2.5.5), devices using the OpenNI protocol will be upgraded to UVC protocol. See the upgrade document for details.

For legacy v1.x device support (Astra+, Astra Pro Plus, Gemini 2 XL), use the main branch.

For detailed branch comparison and device support matrix, see Introduction - Device Support Comparison.

Why pyorbbecsdk?

📷 RGB-D streaming — Depth, color, and infrared streams with configurable resolution and FPS.
🛠️ Post-processing filters — Temporal, Spatial (Advanced), HoleFilling, Threshold, Decimation, Noise Removal.
🎯 Depth-color alignment — Software AlignFilter and hardware D2C alignment.
☁️ Point cloud generation — Colored 3D point clouds via PointCloudFilter.
📐 Camera calibration data — Access intrinsics, distortion coefficients, and extrinsic transforms.
⚡ Real-time performance — Backed by native C++ performance via pybind11.
🌐 Network cameras — Connect to Femto Mega / Gemini 2 XL over Ethernet.
📦 Pre-built wheels — No compilation required for Windows x64, Linux x64, and ARM64.

Getting started

The pyorbbecsdk contains all the libraries that power your camera along with tools that let you experiment with its features and settings.

To get started:

1. Install the package via PyPI (recommended) or from GitHub Release:

pip install --upgrade pyorbbecsdk2

💡 Recommended: Use Virtual Environment

Modern systems (e.g., macOS, Ubuntu 24.04+) restrict pip installations to the system Python. Using a virtual environment avoids permission errors:
# Create and activate virtual environment
python3 -m venv orbbec_env
source orbbec_env/bin/activate  # Linux/macOS
# .\orbbec_env\Scripts\Activate.ps1  # Windows PowerShell

# Install SDK in virtual environment
pip install --upgrade pyorbbecsdk2
See Virtual Environment Guide for more options (venv, pyenv, conda).

🔧 Building from Source? See the Build with UV Guide for detailed instructions.

Note for Linux users: PyPI does not provide pre-built wheels for Python 3.8 on Linux (x64 and ARM64). If you need Python 3.8 on Linux, download the wheel from GitHub Releases or build from source.

2. Setup the environment (one-time OS-level configuration for metadata and udev rules):

# From the repository

# Windows (PowerShell — will auto-request Administrator)
python scripts/env_setup/setup_env.py
# Linux (will auto-request sudo)
python3 scripts/env_setup/setup_env.py

# Or from the installed package
python $(python -c "import pyorbbecsdk, os; print(os.path.dirname(pyorbbecsdk.__file__))")/shared/setup_env.py

3. Start experimenting with the SDK's Quick Start code:

from pyorbbecsdk import *

pipeline = Pipeline()
pipeline.start()                        # uses default config from OrbbecSDKConfig.xml
frames = pipeline.wait_for_frames(1000) # get synchronized Color + Depth frames

For full visualisation, check out examples/quick_start.py. Running result:

quick_start_result

Samples

The examples/ directory contains 35+ scripts organized by difficulty to start using the pyorbbecsdk with only a few lines of code.

Level	Category	Description
⭐	Quick Start	Zero-config RGBD viewer — first thing to run.
⭐⭐	Beginner	Hello camera, depth viz, alignment, calibration, point cloud, multi-stream, IMU, network camera, and firmware update.
⭐⭐⭐	Advanced	Recording & playback, device control, filter chains, HDR, presets, depth work modes, multi-device sync, coordinate transforms, high-performance pipeline.
⭐⭐⭐⭐	Applications	YOLO object detection with depth overlay; interactive depth ruler.
⭐⭐⭐⭐	LiDAR	LiDAR streaming, control, recording, and playback.

See examples/README.md for the full list with per-script descriptions and device compatibility.

📚 Next Steps: Explore our structured learning path from beginner to advanced → Quick Start Guide - Next Steps

Supported Platforms

pyorbbecsdk supports the following operating systems and architectures:

Windows 10 or later: x64 architectures
Linux x64: tested on Ubuntu 18.04, 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
macOS: tested on M2 chip, OS version 13.2

Supported Python versions: 3.8 to 3.13

Quick Camera Evaluation

Want to test your camera without writing code? Download Orbbec Viewer — a standalone GUI application that lets you immediately view camera streams, adjust settings, and verify device functionality.

(Click a platform icon below to download Orbbec Viewer for your OS)


Windows (x64)	Linux (x64)	Linux (ARM64)	macOS (ARM)

Automated Firmware Update

If you encounter errors related to firmware version mismatch, please use the automated update assistant:

python scripts/auto_update_firmware.py

This script will check your current device firmware version, automatically download the correct firmware, and perform the firmware update safely.

If you prefer to manually download firmware files, they are available at the OrbbecFirmware repository.

For detailed device support and firmware compatibility information, see Introduction — v2-main Branch.

FAQ

See the full FAQ for common issues and solutions.

Community

Join the conversation and connect with other pyorbbecsdk users to share ideas, solve problems, and help make the SDK awesome.

GitHub Issues If you come across a bug or want to request a feature, please raise an issue in this GitHub repository.
Documentation The comprehensive Orbbec SDK V2 Python Wrapper User Guide covers architecture, API quick-starts, and usage guides.
Contributing Contributions are welcome — read CONTRIBUTING.md for build instructions, code style, and the PR process.

Changelog

See CHANGELOG.md for a detailed history of changes.

License

This project is licensed under the Apache License 2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pyorbbecsdk2-2.1.2-cp313-cp313-win_amd64.whl (17.6 MB view details)

Uploaded Aug 11, 2026 CPython 3.13Windows x86-64

pyorbbecsdk2-2.1.2-cp313-cp313-manylinux_2_27_x86_64.whl (31.5 MB view details)

Uploaded Aug 11, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64

pyorbbecsdk2-2.1.2-cp313-cp313-manylinux_2_27_aarch64.whl (32.3 MB view details)

Uploaded Aug 11, 2026 CPython 3.13manylinux: glibc 2.27+ ARM64

pyorbbecsdk2-2.1.2-cp313-cp313-macosx_13_0_arm64.whl (37.7 MB view details)

Uploaded Aug 11, 2026 CPython 3.13macOS 13.0+ ARM64

pyorbbecsdk2-2.1.2-cp312-cp312-win_amd64.whl (17.6 MB view details)

Uploaded Aug 11, 2026 CPython 3.12Windows x86-64

pyorbbecsdk2-2.1.2-cp312-cp312-manylinux_2_27_x86_64.whl (31.5 MB view details)

Uploaded Aug 11, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64

pyorbbecsdk2-2.1.2-cp312-cp312-manylinux_2_27_aarch64.whl (32.3 MB view details)

Uploaded Aug 11, 2026 CPython 3.12manylinux: glibc 2.27+ ARM64

pyorbbecsdk2-2.1.2-cp312-cp312-macosx_13_0_arm64.whl (37.7 MB view details)

Uploaded Aug 11, 2026 CPython 3.12macOS 13.0+ ARM64

pyorbbecsdk2-2.1.2-cp311-cp311-win_amd64.whl (17.6 MB view details)

Uploaded Aug 11, 2026 CPython 3.11Windows x86-64

pyorbbecsdk2-2.1.2-cp311-cp311-manylinux_2_27_x86_64.whl (31.5 MB view details)

Uploaded Aug 11, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64

pyorbbecsdk2-2.1.2-cp311-cp311-manylinux_2_27_aarch64.whl (32.3 MB view details)

Uploaded Aug 11, 2026 CPython 3.11manylinux: glibc 2.27+ ARM64

pyorbbecsdk2-2.1.2-cp311-cp311-macosx_13_0_arm64.whl (37.7 MB view details)

Uploaded Aug 11, 2026 CPython 3.11macOS 13.0+ ARM64

pyorbbecsdk2-2.1.2-cp310-cp310-win_amd64.whl (17.6 MB view details)

Uploaded Aug 11, 2026 CPython 3.10Windows x86-64

pyorbbecsdk2-2.1.2-cp310-cp310-manylinux_2_27_x86_64.whl (31.5 MB view details)

Uploaded Aug 11, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64

pyorbbecsdk2-2.1.2-cp310-cp310-manylinux_2_27_aarch64.whl (32.3 MB view details)

Uploaded Aug 11, 2026 CPython 3.10manylinux: glibc 2.27+ ARM64

pyorbbecsdk2-2.1.2-cp310-cp310-macosx_13_0_arm64.whl (37.7 MB view details)

Uploaded Aug 11, 2026 CPython 3.10macOS 13.0+ ARM64

pyorbbecsdk2-2.1.2-cp39-cp39-win_amd64.whl (17.6 MB view details)

Uploaded Aug 11, 2026 CPython 3.9Windows x86-64

pyorbbecsdk2-2.1.2-cp39-cp39-manylinux_2_27_x86_64.whl (31.5 MB view details)

Uploaded Aug 11, 2026 CPython 3.9manylinux: glibc 2.27+ x86-64

pyorbbecsdk2-2.1.2-cp39-cp39-manylinux_2_27_aarch64.whl (32.3 MB view details)

Uploaded Aug 11, 2026 CPython 3.9manylinux: glibc 2.27+ ARM64

pyorbbecsdk2-2.1.2-cp39-cp39-macosx_13_0_arm64.whl (37.7 MB view details)

Uploaded Aug 11, 2026 CPython 3.9macOS 13.0+ ARM64

pyorbbecsdk2-2.1.2-cp38-cp38-win_amd64.whl (17.6 MB view details)

Uploaded Aug 11, 2026 CPython 3.8Windows x86-64

pyorbbecsdk2-2.1.2-cp38-cp38-manylinux_2_27_x86_64.whl (31.5 MB view details)

Uploaded Aug 11, 2026 CPython 3.8manylinux: glibc 2.27+ x86-64

pyorbbecsdk2-2.1.2-cp38-cp38-manylinux_2_27_aarch64.whl (32.3 MB view details)

Uploaded Aug 11, 2026 CPython 3.8manylinux: glibc 2.27+ ARM64

pyorbbecsdk2-2.1.2-cp38-cp38-macosx_13_0_arm64.whl (37.7 MB view details)

Uploaded Aug 11, 2026 CPython 3.8macOS 13.0+ ARM64

File details

Details for the file pyorbbecsdk2-2.1.2-cp313-cp313-win_amd64.whl.

File metadata

Download URL: pyorbbecsdk2-2.1.2-cp313-cp313-win_amd64.whl
Upload date: Aug 11, 2026
Size: 17.6 MB
Tags: CPython 3.13, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.10.20

File hashes

Hashes for pyorbbecsdk2-2.1.2-cp313-cp313-win_amd64.whl
Algorithm	Hash digest
SHA256	`e4ef5dc280ac1d9e2b8eb2a0751f96ce59724a505aa231e196ccd843c5fe98fc`
MD5	`7313ebc3554ca915184b7bf3dab7089e`
BLAKE2b-256	`f3740b96b7dbd2908eb149a0bfba3bf30cdc91a15e9ffe9e9f2a7eb8cd0a1b29`

Algorithm	Hash digest
SHA256	`0042d9ea3f73fe3ecfdbb101445ac6f224c23ad413ec716bcc1dd47c2b3ddac5`
MD5	`ba1456c254bd7f7d20cce504d96a359e`
BLAKE2b-256	`b8aad38a9bbe066318b356cbbd4f51912520828bf482a314dc58015bf9b980cf`

Algorithm	Hash digest
SHA256	`f7faa5134f8584e93c928464327abc516a262a862931c9a7c82f7725f3c47a1b`
MD5	`58d3b8ad2219e3d345a4ef3532f8229e`
BLAKE2b-256	`cf99174bb3f42528d9c763215fea9621bff824f8e5ddc66425856df8b00108f5`

Algorithm	Hash digest
SHA256	`2147457be94e4795668f89787df2c8a26b50027e6ba2e5dbab9986b5757dfe89`
MD5	`e91dae4194a1754eabbb2d2a18427cbc`
BLAKE2b-256	`e0414ba6de01fca4dcc0394401dea3501294fd31e5b82b1bd46258fd10e7f7bb`

Algorithm	Hash digest
SHA256	`8ddfa19267cd52f98860989c486b99481ae6d815274fa69fd98d47ca0951cc45`
MD5	`be9a43abb2b4e7fe7cd9be31a972a4ba`
BLAKE2b-256	`842620a0dec1ea72c71101fb0ce7db967c4c88668c25496858ea64ec399ae6cf`

Algorithm	Hash digest
SHA256	`9baac79e3ac24496847aa595267a6f21a2fb4fddf672493052e65ee48398566b`
MD5	`21cc7828c7c1af05fbaba6aafb395f56`
BLAKE2b-256	`e423f20e2ce5137bb7fad9d16c776e94ac43864c94f7857768e62bbbc232171c`

Algorithm	Hash digest
SHA256	`82f2458b9814db0c9f2a75035faa844676afe8dc6912e3816abe239cb28d753d`
MD5	`fd42ad825452b5e94a9a62213d6c0707`
BLAKE2b-256	`3ab3967b5e8ccc9796bd18a6d6bd61da3c5fc37a9b9121ac31f56c7f58431b62`

Algorithm	Hash digest
SHA256	`b89edb91af1d39d36193e6cf088cdca13fbf6ea9846162fd91f6de715def94d9`
MD5	`4b5b5cccbf56bba0e7ec199579cdd901`
BLAKE2b-256	`f2e7a782a1393fd4df467bf8ed95c918712768b56411deb7021dd49d30a39252`

Algorithm	Hash digest
SHA256	`651a6d89177c19cfacd256e25ece21ab3ff878b4b1c98209298ebf41f0ca24a3`
MD5	`648f877b0fa2bbb5a221424cda53e1eb`
BLAKE2b-256	`b2663b33ba4313b7b504091ce19ac4b361449fb7fdbf01680b1710dc7c2984c0`

Algorithm	Hash digest
SHA256	`8837d8f177266e795e5cc7f6906bbda7411887d1277f5a16753fa4a390ebe6fa`
MD5	`f9ef99d1349971b7912d51dd55afdd5e`
BLAKE2b-256	`d2a90ce1a6d3f4bff42dba636accb999308000787c95c01fc674ca02223e0260`

Algorithm	Hash digest
SHA256	`76924a78778e37b4c20b87dd6e490b4b945910ff41cb5c5cbdf968e52728a1d3`
MD5	`cb1dd3a45d90a9fce770dc34ec2bfbc5`
BLAKE2b-256	`3dd782fef8d49baa6f1a896e9090feab68bf3b102ffe3fc868ae54369dd01636`

Algorithm	Hash digest
SHA256	`6e2b091e74b29f0ea2802c41263e37f63ebdf67cd6342740028dc4d2c42c0a84`
MD5	`890bc78f812b90afc484296b20d8c5cc`
BLAKE2b-256	`8743e9bed249a6ba5cf9b4fbb0e63a1ae3cbd7b749afd63bea2b48a1eda759e5`

Algorithm	Hash digest
SHA256	`19506ba528052deb54f54bfca564a541864e5b7ddf32d65b6d91a0ac0925a6ed`
MD5	`ca148244f7be396a5a600e0315c76b7d`
BLAKE2b-256	`fd9ff89ae9d74e84d23c6b010f8a2d75815f9ebb4e2c4bde1120e93aa516feee`

Algorithm	Hash digest
SHA256	`e1d3e207995ac60e2bf3350086777df1ba15669a41c6dcfb81c0d896cbb17fcb`
MD5	`40722298375e96420afed7d20f17980a`
BLAKE2b-256	`921aa3212f2ec2da16e857f4169eddb1d929a36dc33aa3fb7f5dc0b893cc9eb9`

Algorithm	Hash digest
SHA256	`62eba57a0806ed46826916e6327990214b490ac889a7ccb1bf18f7862033a454`
MD5	`6963b1dff1bb8f8f829c7ed5ab9d5d9f`
BLAKE2b-256	`fcf76fcac18ca17fe7828a45befdde0ce9e412aa71ef98476e8d24a9c102f6da`

Algorithm	Hash digest
SHA256	`60acb12afd0fdca0c963273d58362f2d1ac61c61a852fe5499f5b25fc3fd416b`
MD5	`c996507b0a198a8f6ade0bd5f0745667`
BLAKE2b-256	`3e21323e9c1f901ae538732c8bcb1478222427087fc6678f8150225a4e9da793`

Algorithm	Hash digest
SHA256	`2d3fa746e9872dc1ebcbd9d9eae8220fa2ef67db452d3d231073e9197a8467e1`
MD5	`d83481381308c32fe13e1d4d2434d18d`
BLAKE2b-256	`d3c9cd0f62cfb3124db6aca6a592cfcf51ff4c6713f23da087e94e84ed6ba478`

Algorithm	Hash digest
SHA256	`cf18a50230e7130d8bc91c5ecefd6826928dc2b15184b257caf48c1ac9b64657`
MD5	`cbe675faf62d601dff0fe677a5db2c91`
BLAKE2b-256	`7025ec8684fd27adb8eec307456e320548b27ffaccb86b9b8ce38c775d3367b5`

Algorithm	Hash digest
SHA256	`71e4b4d49ef4740b9107b234c68edb56a8115cafc69016679f1ec3b722a7f44a`
MD5	`6c750cd3f17e4bbfc4f641f5c06571a3`
BLAKE2b-256	`577793a0050b46af79b925d2b371d313737a9dd521bdd4683cf1e388a46a0915`

Algorithm	Hash digest
SHA256	`78a438d426a19af415e350baafcac9a760a8ab2ddacb75347abe51ca933e1f6a`
MD5	`0f1593ce3c129b94e0c9872f87f98c2e`
BLAKE2b-256	`8dd0192fc54089a7f5cf3b9b9f3ac4ca2ee90dea4af90babcc33e16e57ecc6c3`

Algorithm	Hash digest
SHA256	`9f2e1a6d5780424391c674e8c93ec9bc1cec347999fe227862940c317714904e`
MD5	`af2e51280a11752e33edbd39f9497edd`
BLAKE2b-256	`d16e4f12765f8c8c154a3e6c1fe691abeb994cb9e6fe20f60270f6b452889bd1`

pyorbbecsdk2 2.1.2

pyorbbecsdk

Table of Contents

Overview

Supported Devices

Why pyorbbecsdk?

Getting started

Samples

Supported Platforms

Quick Camera Evaluation

Automated Firmware Update

FAQ

Community

Changelog

License

Key dates

2 maintainers

Credits

Requires

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`2ac4ff26d32ce3a677ad22509153f8b047cc2f23133eed8823a5718083dd9c92`
MD5	`3022ecee743cb5473b0db1c57f645435`
BLAKE2b-256	`29ab1639d667fcf714d85c55fa55952c44fc69ac523623863ed67f9896c38d73`

Algorithm	Hash digest
SHA256	`13bee7bda29a26f949b6873bfda0d2796cd6fe394fed6dd9300af4fc090f1446`
MD5	`5c81a3f22ab2dcbd0bd3187c12dc14a8`
BLAKE2b-256	`38c85bccbc499b4e55037fa1673e6943767e7d199b1eec841f37d33b4fa988fa`

Algorithm	Hash digest
SHA256	`685c84861a2d1ebf616156116903ad6a96fc1602b975433591d270728fdad15c`
MD5	`a3f2d94a05c4a25fa3487fc0973c4491`
BLAKE2b-256	`63b24b2fe4339b2065f1af1cdb370809874897c582db5209c27fe8b1de63b270`