Convert Figma logo to code with AI

realsenseai logolibrealsense

RealSense™ SDK

8,328
4,932
8,328
384

Quick Overview

Error generating quick overview

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

Logo for light mode Logo for dark mode

RealSense SDK 2.0 is a cross-platform library for RealSense depth cameras. The SDK allows depth and color streaming, and provides intrinsic and extrinsic calibration information.

License Latest release Commits since Issues GitHub CI Forks

Use Cases

Below are some of the many real-world applications powered by RealSense technology:

RoboticsDepth Sensing3D Scanning
DronesSkeletal and People TrackingFacial Authentication

Why RealSense?

  • High-resolution color and depth at close and long ranges
  • Open source SDK with rich examples and wrappers (Python, ROS, C#, Unity and more...)
  • Active developer community and defacto-standard 3D stereo camera for robotics
  • Cross-platform support: Windows, Linux, macOS, Android, and Docker

Product Line

RealSense stereo depth products use stereo vision to calculate depth, providing high-quality performance in various lighting and environmental conditions.

Here are some examples of the supported models:

ProductImageDescription
D555 PoEThe RealSense™ Depth Camera D555 introduces Power over Ethernet (PoE) interface on chip, expanding our portfolio of USB and GMSL/FAKRA products.
D457 GMSL/FAKRAThe RealSense™ Depth Camera D457 is our first GMSL/FAKRA high bandwidth stereo camera. The D457 has an IP65 grade enclosure protecting it from dust ingress and projected water.
D455The RealSense D455 is a long-range stereo depth camera with a 95 mm baseline, global-shutter depth sensors, an RGB sensor, and a built-in IMU, delivering accurate depth at distances up to 10 m..
D435ifThe D435if is one of RealSense™ Depth Camera with IR pass filter family expanding our portfolio targeting the growing robotic market. The D400f family utilizes an IR pass filter to enhance depth quality and performance range in many robotic environments.
D405The RealSense™ Depth Camera D405 is a short-range stereo camera providing sub-millimeter accuracy for your close-range computer vision needs.

🛍️ Explore more stereo products

Getting Started

Start developing with RealSense in minutes using either method below.

1️. Precompiled SDK

This is the best option if you want to plug in your camera and get started right away.

  1. Download the latest SDK bundle from the Releases page.
  2. Connect your RealSense camera.
  3. Run the included tools:

Setup Guides - precompiled SDK

Linux\Jetson Guide Windows Guide

Note: For minor releases, we publish Debian packages as release artifacts that you can download and install directly.

2️. Build from Source

For a more custom installation, follow these steps to build the SDK from source.

  1. Clone the repository and create a build directory:
    git clone https://github.com/realsenseai/librealsense.git
    cd librealsense
    mkdir build && cd build
    
  2. Run CMake to configure the build:
    cmake ..
    
  3. Build the project:
    cmake --build .
    

Setup Guides - build from source

Linux Guide Jetson Guide Windows Guide macOS Guide

Python Packages

pyrealsense2 PyPI - pyrealsense2-beta

Which should I use?

  • Stable: pyrealsense2 — validated releases aligned with SDK tags (Recommended for most users).
  • Beta: pyrealsense2-beta — fresher builds for early access and testing. Expect faster updates.

Install

pip install pyrealsense2 # Stable
pip install pyrealsense2-beta # Beta

Both packages import as pyrealsense2. Install only one at a time.

Ready to Hack!

Our library offers a high level API for using RealSense depth cameras (in addition to lower level ones). The following snippets show how to start streaming frames and extracting the depth value of a pixel:

C++

#include <librealsense2/rs.hpp>
#include <iostream>

int main() {
    rs2::pipeline p;                 // Top-level API for streaming & processing frames
    p.start();                       // Configure and start the pipeline

    while (true) {
        rs2::frameset frames = p.wait_for_frames();        // Block until frames arrive
        rs2::depth_frame depth = frames.get_depth_frame(); // Get depth frame
        if (!depth) continue;

        int w = depth.get_width(), h = depth.get_height();
        float dist = depth.get_distance(w/2, h/2);         // Distance to center pixel
        std::cout << "The camera is facing an object " << dist << " meters away\r";
    }
}

Python

import pyrealsense2 as rs

pipeline = rs.pipeline() # Create a pipeline
pipeline.start() # Start streaming

try:
    while True:
        frames = pipeline.wait_for_frames()
        depth_frame = frames.get_depth_frame()
        if not depth_frame:
            continue

        width, height = depth_frame.get_width(), depth_frame.get_height()
        dist = depth_frame.get_distance(width // 2, height // 2)
        print(f"The camera is facing an object {dist:.3f} meters away", end="\r")

finally:
    pipeline.stop() # Stop streaming

For more information on the library, please follow our examples or tools, and read the documentation to learn more.

Supported Platforms

Operating Systems and Platforms

UbuntuWindowsmacOS High SierraJetsonRaspberry Pi
Ubuntu
Windows
macOS

Programming Languages and Wrappers

C++CC#PythonROS 2Rest API
ROS 2
Rest API

For more platforms and wrappers look over here.

Full feature support varies by platform – refer to the release notes for details.

Community & Support

🔎 Looking for legacy devices (F200, R200, LR200, ZR300)? Visit the legacy release.


You can find us at

GitHub     X (Twitter)     YouTube     LinkedIn     Community