Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
depthai | 2.30.0 |
README
DepthAI C++ Library
Core C++ library
Documentation
Documentation is available over at Luxonis DepthAI API
Disclaimer
DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
Dependencies
- CMake >= 3.10
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- [optional] PCL (required for point cloud example)
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
ℹ️ On Linux distributions based on RPMs, you need to install
perl-core
required by OpenSSL dependency.sudo yum install perl-core
Another option is to disable CURL support by setting
DEPTHAI_ENABLE_CURL=OFF
when configuring CMake.cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S. -Bbuild
cmake --build build
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
(CMake >= 3.12). For older versions use: Linux/macOS:cmake --build build -- -j[num CPU cores]
, MSVC:cmake --build build -- /MP[num CPU cores]
⚠️ If any CMake commands error with
CMake Error: The source directory "" does not exist.
replace argument-S
with-H
Dynamic library
To build dynamic version of library configure with following option added
cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build
Android
Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.
Steps:
- Install Android NDK (for example via Android Studio).
- Set the NDK path:
export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version
- Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
- Run cmake, set your ABI and Platform as needed:
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build
Running examples
To build the examples configure with following option added
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Then navigate to build/examples
folder and run a preferred example
``` cd build/examples ./MobileNet/rgb_mobilenet
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
depthai | 2.30.0 |
README
DepthAI C++ Library
Core C++ library
Documentation
Documentation is available over at Luxonis DepthAI API
Disclaimer
DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
Dependencies
- CMake >= 3.10
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- [optional] PCL (required for point cloud example)
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
ℹ️ On Linux distributions based on RPMs, you need to install
perl-core
required by OpenSSL dependency.sudo yum install perl-core
Another option is to disable CURL support by setting
DEPTHAI_ENABLE_CURL=OFF
when configuring CMake.cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S. -Bbuild
cmake --build build
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
(CMake >= 3.12). For older versions use: Linux/macOS:cmake --build build -- -j[num CPU cores]
, MSVC:cmake --build build -- /MP[num CPU cores]
⚠️ If any CMake commands error with
CMake Error: The source directory "" does not exist.
replace argument-S
with-H
Dynamic library
To build dynamic version of library configure with following option added
cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build
Android
Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.
Steps:
- Install Android NDK (for example via Android Studio).
- Set the NDK path:
export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version
- Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
- Run cmake, set your ABI and Platform as needed:
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build
Running examples
To build the examples configure with following option added
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Then navigate to build/examples
folder and run a preferred example
``` cd build/examples ./MobileNet/rgb_mobilenet
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
depthai | 2.30.0 |
README
DepthAI C++ Library
Core C++ library
Documentation
Documentation is available over at Luxonis DepthAI API
Disclaimer
DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
Dependencies
- CMake >= 3.10
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- [optional] PCL (required for point cloud example)
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
ℹ️ On Linux distributions based on RPMs, you need to install
perl-core
required by OpenSSL dependency.sudo yum install perl-core
Another option is to disable CURL support by setting
DEPTHAI_ENABLE_CURL=OFF
when configuring CMake.cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S. -Bbuild
cmake --build build
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
(CMake >= 3.12). For older versions use: Linux/macOS:cmake --build build -- -j[num CPU cores]
, MSVC:cmake --build build -- /MP[num CPU cores]
⚠️ If any CMake commands error with
CMake Error: The source directory "" does not exist.
replace argument-S
with-H
Dynamic library
To build dynamic version of library configure with following option added
cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build
Android
Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.
Steps:
- Install Android NDK (for example via Android Studio).
- Set the NDK path:
export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version
- Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
- Run cmake, set your ABI and Platform as needed:
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build
Running examples
To build the examples configure with following option added
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Then navigate to build/examples
folder and run a preferred example
``` cd build/examples ./MobileNet/rgb_mobilenet
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
depthai | 2.30.0 |
README
DepthAI C++ Library
Core C++ library
Documentation
Documentation is available over at Luxonis DepthAI API
Disclaimer
DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
Dependencies
- CMake >= 3.10
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- [optional] PCL (required for point cloud example)
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
ℹ️ On Linux distributions based on RPMs, you need to install
perl-core
required by OpenSSL dependency.sudo yum install perl-core
Another option is to disable CURL support by setting
DEPTHAI_ENABLE_CURL=OFF
when configuring CMake.cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S. -Bbuild
cmake --build build
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
(CMake >= 3.12). For older versions use: Linux/macOS:cmake --build build -- -j[num CPU cores]
, MSVC:cmake --build build -- /MP[num CPU cores]
⚠️ If any CMake commands error with
CMake Error: The source directory "" does not exist.
replace argument-S
with-H
Dynamic library
To build dynamic version of library configure with following option added
cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build
Android
Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.
Steps:
- Install Android NDK (for example via Android Studio).
- Set the NDK path:
export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version
- Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
- Run cmake, set your ABI and Platform as needed:
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build
Running examples
To build the examples configure with following option added
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Then navigate to build/examples
folder and run a preferred example
``` cd build/examples ./MobileNet/rgb_mobilenet
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
depthai | 2.30.0 |
README
DepthAI C++ Library
Core C++ library
Documentation
Documentation is available over at Luxonis DepthAI API
Disclaimer
DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
Dependencies
- CMake >= 3.10
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- [optional] PCL (required for point cloud example)
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
ℹ️ On Linux distributions based on RPMs, you need to install
perl-core
required by OpenSSL dependency.sudo yum install perl-core
Another option is to disable CURL support by setting
DEPTHAI_ENABLE_CURL=OFF
when configuring CMake.cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S. -Bbuild
cmake --build build
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
(CMake >= 3.12). For older versions use: Linux/macOS:cmake --build build -- -j[num CPU cores]
, MSVC:cmake --build build -- /MP[num CPU cores]
⚠️ If any CMake commands error with
CMake Error: The source directory "" does not exist.
replace argument-S
with-H
Dynamic library
To build dynamic version of library configure with following option added
cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build
Android
Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.
Steps:
- Install Android NDK (for example via Android Studio).
- Set the NDK path:
export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version
- Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
- Run cmake, set your ABI and Platform as needed:
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build
Running examples
To build the examples configure with following option added
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Then navigate to build/examples
folder and run a preferred example
``` cd build/examples ./MobileNet/rgb_mobilenet
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
depthai | 2.30.0 |
README
DepthAI C++ Library
Core C++ library
Documentation
Documentation is available over at Luxonis DepthAI API
Disclaimer
DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
Dependencies
- CMake >= 3.10
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- [optional] PCL (required for point cloud example)
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
ℹ️ On Linux distributions based on RPMs, you need to install
perl-core
required by OpenSSL dependency.sudo yum install perl-core
Another option is to disable CURL support by setting
DEPTHAI_ENABLE_CURL=OFF
when configuring CMake.cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S. -Bbuild
cmake --build build
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
(CMake >= 3.12). For older versions use: Linux/macOS:cmake --build build -- -j[num CPU cores]
, MSVC:cmake --build build -- /MP[num CPU cores]
⚠️ If any CMake commands error with
CMake Error: The source directory "" does not exist.
replace argument-S
with-H
Dynamic library
To build dynamic version of library configure with following option added
cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build
Android
Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.
Steps:
- Install Android NDK (for example via Android Studio).
- Set the NDK path:
export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version
- Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
- Run cmake, set your ABI and Platform as needed:
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build
Running examples
To build the examples configure with following option added
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Then navigate to build/examples
folder and run a preferred example
``` cd build/examples ./MobileNet/rgb_mobilenet
File truncated at 100 lines see the full file