此页面由 AI 自动翻译。查看英文原版
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

软件

使用以下链接可以跳过分步介绍,直接深入了解 Luxonis SDK 和完整的 OAK 软件栈:DepthAI API、工具以及 OAK USB、PoE 和 OAK4 摄像机的示例。

DepthAI API (Python/C++)

DepthAI v3 SDK 库,用于在 OAK 和 OAK4 摄像机上构建管道和应用程序。
打开 DepthAI API 文档

oakctl CLI

用于管理和配置 OAK4 设备以及部署应用程序的命令行工具。
安装 oakctl

DepthAI 示例

用于在 OAK 摄像机上构建 DepthAI 管道的参考示例。
浏览示例
要轻松分步介绍 OAK4 和 OAK 设备,请按照以下步骤操作。
为您的设备选择正确的入门指南。

连接 OAK4

使用基于 RVC4 的 OAK4 入门指南来设置硬件并执行初始配置。
OAK4 入门
OAK4

连接 OAK

按照基于 RVC2 的 OAK 入门指南,了解如何将其连接到您的主机 PC。
OAK 入门
OAK4
连接摄像机后,最快的入门方法是运行 OAK Viewer。

OAK Viewer

OAK Viewer 是一款桌面 GUI 应用程序,可让您可视化摄像机的流并与设备交互。它适用于 Windows、macOS 和 Linux。警告: 在 OAK Viewer 中,您只能测试 Viewer 中包含的选定 Luxonis 模型 Zoo 模型。您无法上传自定义模型或使用其他 Zoo 模型。有关自定义模型上传和验证,请参阅 在 HubAI 上使用自定义模型教程。
点击此处开始
OAK Viewer
尝试我们的 预制应用程序,以初步了解我们的生态系统。以下是启动通用神经网络应用程序的示例:

使用 OAK4 运行第一个应用程序

安装 oakctl

Linux/MacOS

在 64 位系统上,运行:
Command Line
1bash -c "$(curl -fsSL https://oakctl-releases.luxonis.com/oakctl-installer.sh)"

Windows

使用 Windows 安装程序 下载并安装。

部署示例应用程序

Command Line
1# 连接到设备
2oakctl connect
3# 克隆仓库
4git clone --depth 1 --branch main https://github.com/luxonis/oak-examples.git
5# 切换到 generic-example 目录
6cd oak-examples/neural-networks/generic-example/
7# 运行应用程序并按照说明打开 Web 查看器
8oakctl app run .
继续探索其他预制应用程序

使用 OAK 运行第一个应用程序

Linux/MacOS

Command Line
1# 克隆仓库
2git clone --depth 1 --branch main https://github.com/luxonis/oak-examples.git
3# 切换到 generic-example 目录
4cd oak-examples/neural-networks/generic-example/
5# 创建并进入虚拟 Python 环境
6python3 -m venv venv
7source venv/bin/activate
8# 将依赖项安装到环境中
9pip install -r requirements.txt
10# 运行应用程序并按照说明打开 Web 查看器
11python3 main.py

Windows

Command Line
1# 克隆仓库
2git clone --depth 1 --branch main https://github.com/luxonis/oak-examples.git
3# 切换到 generic-example 目录
4cd oak-examples\neural-networks\generic-example\
5# 安装依赖项
6pip install -r requirements.txt
7# 运行应用程序并按照说明打开 Web 查看器
8python main.py
继续探索其他预制应用程序

独立模式与外设模式

兼容性独立模式¹外设模式²
OAK4✅✅
OAK🚫✅
  1. 独立模式:应用程序仅在摄像机上运行。应用程序通过 oakctl 部署。
  2. 外设模式:应用程序在摄像机上运行,但主机计算机通过 TCP 套接字保持连接。应用程序使用 DepthAI API 运行。最适合快速原型开发。
开始自行开发的快捷方式是使用 模板应用程序。此应用程序是您自己应用程序的起点,包含所有必要的组件,可帮助您快速启动和运行。
Command Line
1# 安装核心包
2pip install depthai --force-reinstall
3# 克隆模板应用
4git clone https://github.com/luxonis/oak-template.git
5# 切换到模板应用目录
6cd oak-template
7# 安装依赖
8pip install -r requirements.txt
这将把模板/cookie-cutter 应用程序下载到您当前的目录。
Text
1template-app/
2├── main.py
3├── oakapp.toml
4├── requirements.txt
5├── media/ # 可选媒体文件
6└── utils/ # 可选辅助函数
继续开发您的模板应用程序
我们建议您通过以下方式之一继续探索生态系统。

OAK 应用程序

为 OAK 设备构建、打包和管理容器化计算机视觉应用程序。
打开 OAK 应用程序概述

DepthAI

使用 DepthAI API 在 OAK 和 OAK4 摄像机上构建和运行实时视觉管道。
打开 DepthAI 概述

AI

探索 OAK 设备的模型部署、推理工作流和 AI 工具。
打开 AI 概述