yahboom
HomeTutorialsProduct
Solution
Blog
Online Store
About Us
EN/中文
Store
Jetson Orin NANO Developer Kit📖
01.Get started
  • 01. Learning route
  • 02. Get started quickly
  • 03. System Update Notes
  • 04. Disabling automatic updates and troubleshooting issues
  • 05. Jetson Orin Nano official kit screwdriver instructions
02.Jetson basic course
  • 01.Jetson board introduction
  • 02.Write Jetson original system
  • 03.Installing Jetson environment
  • 04.Backup SSD system
  • 05.Restore initial image system
  • 06.Upgrade to SUPER version (Optional)
  • 07.Write SUPER boot (Must read)
  • 08.SSD expansion
  • 09.Jetpack old system upgraded to Yahboom SUPER factory system
  • 10.Write the system onto your own SSD
03.Basic setting course
  • 01.Basic knowledge
  • 02.Network configuration
  • 03.SSH remote login
  • 04.VNC remote control
  • 05.RDP remote control
  • 06.Remote file transfer
  • 07.Jtop tool
  • 08.Exchange space expansion
  • 09.Use VSCode
  • 10.Use VMware
  • 11.Modify screen resolution
04.GPIO control course
  • 01.GPIO description
  • 02.GPIO library installation
  • 03.GPIO reading
  • 04.GPIO output
  • 05.Serial communication
  • 06.I2C communication
05.Vision basic course
  • 01.CSI camera preview
  • 02.USB camera preview
  • 03.Use Jupyter Lab
  • 04.Use JetCam
06.OpenCV basic course
  • 01.Image reading
  • 02.Image saving
  • 03.Image modification
  • 04.Image scaling
  • 05.Image cropping
  • 06.Image translation
  • 07.Image mirroring
  • 08.Image grayscale conversion
  • 09.Image binarization
  • 10.Image edge detection
  • 11.Add line segments
  • 12.Add rectangles
  • 13.Add circular shape
  • 14.Add ellipses
  • 15.Add polygons
  • 16.Add Text
  • 17.Preview USB camera image
  • 18.Preview CSI camera image
07.Vision advanced course
01.Environment construction
  • 01.TensorFlow
  • 02.PyTorch
  • 03.Torchvision
02.DeepStream development
  • 01.DeepStream environment
  • 02.License plate detection and recognition
  • 03.Parallel multi-model inference
  • 04.Object embedding vector generation
  • 05.Pose recognition
  • 06.NV optical flow anomaly detection
  • 07.Single-view 3D tracking
  • 08.Multi-view 3D tracking
03.NVIDIA TAO toolkit application
  • 01.Traffic scene object detection
  • 02.Person object detection
  • 03.Vehicle brand classification
  • 04.Vehicle model classification
  • 05.License plate detection and recognition
  • 06.Person semantic segmentation
  • 07.Retail product detection and recognition
  • 08.Person feature extraction and matching (ReID)
  • 09.Person action and pose classification
  • 10.Transformer-based person detection
  • 11.3D human skeleton detection
  • 12.LiDAR 3D point cloud detection
04.YOLO11 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
05.Mediapipe development
  • 01.Mediapipe environment
  • 02.Hand detection
  • 03.Face detection
  • 04.Face effects
  • 05.3D object recognition
  • 06.Virtual brush
  • 07.Gesture recognition
  • 08.Finger control
  • 09.Posture estimation
  • 10.Face mask
  • 11.Overall detection
  • 12.Green scene removal(Human)
06.YOLO26 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
07.QR code recognition
  • QR code recognition
08.Docker basic course
  • 01.Docker introduction
  • 02.Docker installation
  • 03.Docker command
  • 04.Docker usage
  • 05.Docker interaction
09.ROS2-Jazzy
01.ROS2 basic course
  • 1.Introduction to ROS2
  • 2.ROS2 install Jazzy
  • 3.ROS2 development environment
  • 4.ROS2 workspace
  • 5.ROS2 function package
  • 6.ROS2 node
  • 7.ROS2 topic communication
  • 8.ROS2 service communication
  • 9.ROS2 action communication
  • 10.ROS2 custom interface message
  • 11.ROS2 parameter service case
  • 12.ROS2 meta-function package
  • 13.ROS2 distributed communication
  • 14.ROS2 DDS
  • 15.ROS2 time related API
  • 16.ROS2 common command tools
  • 17.ROS2 rviz2 use
  • 18.ROS2 rqt toolbox
  • 19.ROS2 Launch startup file configuration
  • 20.ROS2 recording and playback tool
  • 21.ROS2 URDF model
  • 22.ROS2 Gazebo simulation platform
  • 23.ROS2 TF2 coordinate transformation
02.ROS2 vision course
  • 01.Camera preview (USB)
  • 02.Camera preview (CSI)
  • 03.Camera calibration (USB)
  • 04.Camera calibration (CSI)
  • 05.AR vision (USB)
  • 06.AR vision (CSI)
10.Large model basic course
01.Offline large model
  • 01.AI large model environment deployment
  • 02.Install large model dialogue platform
  • 03.Meta AI - Llama model
  • 04.Alibaba Cloud - Qwen model
  • 05.Microsoft - Phi-4-mini model
  • 06.DeepSeek - DeepSeek model
  • 07.Alibaba Cloud - Qwen-VL visual multimodal large model
  • 08.Google - Gemma visual multimodal large model
  • 9.Llava visual multimodal large model
  • 10.MiniCPM-V visual multimodal large model
  • 11.High-quality vision-language grounding (LocateAnything)
02.Online large model
  • 01.Tongyi Qianwen large model
  • 02.OpenRouter large model API aggregation platform
11.Large model application practice
01.Voice interaction application
  • 1.Voice interaction hardware connection (Must read)
  • 2.Offline speech to text (ASR)
  • 3.Offline text to speech (TTS)
  • 4.AI large model voice interaction
  • 5.AI large model offline voice assistant
02.Multimodal large model application (Online_Offline large model + Text_Voice interaction)
  • 01.Multimodal visual understand application
  • 02.Multimodal text image application
  • 03.Multimodal video analysis application
  • 04.Multi module visual position application
  • 05.Multimodal table scanning application
  • 06.Multimodal autonomous agent application
12.NVIDIA Isaac ROS course
  • 01.Build Isaac ROS environment
  • 02.Deep segmentation
  • 03.DNN stereoscopic depth
  • 04.Free space segmentation
  • 05.Image distortion processing
  • 06.Image segmentation
  • 07.3D scene reconstruction and mapping
  • 08.Object detection
  • 09.3D attitude estimation
  • 10.Visual SLAM
13.OpenClaw deployment and basic usage
01.OpenClaw deployment and introduction
  • 01.Quick start with the pre-configured environment (Recommended)
  • 02.OpenClaw Deployment
  • 03.OpenClaw WhatsApp Plugin Application
  • 04.OpenClaw WebChat Interaction
  • 05.OpenClaw TUI Interaction
  • 06.OpenClaw Tools Introduction
  • 07.OpenClawGate Gateway User Manual
  • 08.OpenClaw Features Overview
  • 09.OpenClawHub Introduction (Skill Installation)
02.OpenClaw basic application
  • 01.OpenClaw Application - File Management
  • 02.OpenClaw Application - Camera
  • 03.OpenClaw Application - Browser Control
  • 04.OpenClaw Application - Script Execution
  • 05.OpenClaw Application - AI Programming (Peripheral & GPIO Control)
  • 06.OpenClaw Application - Dedicated AI Assistant
  • 07.OpenClaw Web Search Capability Configuration
03.NVIDIA official Agent Skills application
  • 01.AI-assisted development with VS Code or Cursor
  • 02.Jetson device skills
  • 03.Jetson BSP custom agent skills
14.OpenClaw advanced development
01.Preparation Before Use
  • 01.Peripheral Hardware Configuration
  • 02.OpenClaw API-KEY Configuration
  • 03.OpenClaw Model Switching
  • 04.OpenClaw Prompts
  • 05.AI Voice Interaction Configuration
  • 06.Three Dialogue Configuration Tests
02.OpenClaw AI Programming Peripheral Control
  • 1. Servo Control
  • 2. RGB Strip
  • 3. OLED Display
  • 4. Temperature and Humidity Sensor
  • 5. Camera Application
  • 6. AI Script Peripheral Control
03.OpenClaw Peripheral Integration Applications
  • 1. Plant Care Assistant
  • 2. AI Calorie Estimation
  • 3. AI Rock Paper Scissors Game
  • 4. AI Pet
  • 5. AI Weather Station
  • 6. Temperature Humidity Dashboard
  • 7. Scheduled Tasks
Download
  • System_File
  • VMFile_BootFile
  • 3D Model File
  • DataSheet
  • Software_Tools
  • Code
  • Manual
Download ZIP

Welcome to Jetson Orin NANO Developer Kit repository

01.YOLO environment construction

YOLO Environment Setup

YOLO Environment Setup1. System Information2. Preparation3. Installing Ultralytics4. Configuring GPU Acceleration4.1. PyTorch GPU Environment4.2. Torchvision Missing the nvJPEG Runtime Library5. Verifying the InstallationCommon ErrorsCannot uninstall sympySymptomSolutionCSI Camera Cannot Be AccessedVerifying the EnvironmentReferences

pip Installation Note: Ubuntu 24.04 marks the system Python as "externally managed" per PEP 668, so installing directly with pip may raise externally-managed-environment. This tutorial installs to the current user directory using --user --break-system-packages. Virtual environments generally do not need these flags.

1. System Information

Applicable environment: Jetson Orin Nano Super, JetPack 7.2.1 / L4T R39.2.1, Ubuntu 24.04, Python 3.12.

This tutorial uses the bundled Ultralytics 8.3.55 source code and reuses PyTorch 2.8.0, Torchvision 0.23.0, and the system OpenCV already configured in earlier tutorials. The system's default CUDA toolkit is 13.2, while the current PyTorch build uses CUDA 12.9; the two do not need to share the same version number.

2. Preparation

Note: If the factory image already includes the environment for this tutorial, you only need to perform the verification in Section 5. When setting up the system yourself, first complete the earlier PyTorch and Torchvision environment setup, then perform the installation steps. The commands below are run in the Jetson terminal.

Check the existing frameworks:

python3 -c "import torch, torchvision, cv2, numpy; print('Torch:', torch.__version__); print('Torchvision:', torchvision.__version__); print('CUDA:', torch.cuda.is_available()); print('OpenCV:', cv2.__version__); print('NumPy:', numpy.__version__)"

The expected results are PyTorch 2.8.0, Torchvision 0.23.0, CUDA True, and NumPy 1.26.4. OpenCV uses the version provided by the current system; the GStreamer support required by CSI cameras is covered under Common Errors. If an import fails or CUDA is False, fix the framework environment first instead of trying to fix it by installing YOLO dependencies.

Install pip:

xxxxxxxxxx
sudo apt update
sudo apt install -y python3-pip

This tutorial reuses existing basic dependencies such as matplotlib, pillow, pyyaml, requests, scipy, psutil, and pandas. You can check them first:

xxxxxxxxxx
python3 -c "import matplotlib, PIL, yaml, requests, scipy, psutil, pandas; print('Basic dependencies importable')"

If a module is reported missing, install that dependency first. The --no-deps installation method used in this tutorial does not automatically install missing dependencies, so it is not suitable for a clean system whose basic frameworks are not yet prepared.

3. Installing Ultralytics

Copy ultralytics.zip from the bundled materials to the Jetson and extract it to the current user's home directory. After extraction, confirm that ~/ultralytics/pyproject.toml exists; the directory should also contain the ultralytics/ source subdirectory.

If ~/ultralytics already contains source code or training data, do not overwrite it directly; first check the current version and the purpose of the directory. The bundled source code is version 8.3.55.

Enter the source directory, install the basic dependencies, and install the package:

​x
cd ~/ultralytics

python3 -m pip install --user --break-system-packages --no-deps \
    tqdm py-cpuinfo seaborn ultralytics-thop

python3 -m pip install --user --break-system-packages --no-deps -e .

export PATH="$HOME/.local/bin:$PATH"

--no-deps prevents pip from automatically replacing the currently verified PyTorch, Torchvision, and system OpenCV; -e . means the local source code is used directly, so later source modifications take effect.

The export only applies to the current terminal. If a new terminal reports that yolo cannot be found, run that command again, or use ~/.local/bin/yolo directly.

Do not use sudo pip3 install ultralytics[export] as a substitute for the steps above. For 8.3.55, the [export] extra dependencies require installing the old NumPy 1.23.5 on ARM64 and pull in other export frameworks, which does not match the current Python 3.12 environment. After installation as a normal user, no system reboot is needed.

4. Configuring GPU Acceleration

4.1. PyTorch GPU Environment

PyTorch 2.8.0 and Torchvision 0.23.0 were already installed and verified earlier.

xxxxxxxxxx
python3 -c "import torch; print('Torch:', torch.__version__); print('CUDA used for build:', torch.version.cuda); print('CUDA available:', torch.cuda.is_available()); print('GPU:', torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'Unavailable')"

On Python 3.12, you cannot install PyTorch, Torchvision, or ONNX Runtime wheels whose filenames contain cp310. Whether cuSPARSELt is needed should be determined by the actual PyTorch build dependencies and the current system repositories; it is not included as a standard installation step in this section.

4.2. Torchvision Missing the nvJPEG Runtime Library

If importing Torchvision reports libnvjpeg.so.12: cannot open shared object file, the fix for the current CUDA 12.9 build is:

xxxxxxxxxx
sudo apt-get install -y libnvjpeg-12-9
sudo ldconfig

ldconfig -p | grep libnvjpeg
python3 -c "import torchvision; print(torchvision.__version__)"

If you do not see that error, there is no need to install it again. This step installs the nvJPEG runtime library for CUDA 12.9 and does not require switching the system's default CUDA toolkit.

5. Verifying the Installation

Verify Torch, Torchvision, and NumPy

xxxxxxxxxx
python3 -c "import ultralytics; print(ultralytics.__version__)"
python3 -c "import torch; print(torch.__version__); print(torch.cuda.is_available())"
python3 -c "import torchvision; print(torchvision.__version__)"
python3 -c "import numpy; print(numpy.__version__)"

The expected result should match the figure below:

Verify Actual GPU Inference

Run the following, assuming the bundled source includes the yolo11n.pt weights and the bus.jpg image:

xxxxxxxxxx
cd ~/ultralytics
ls -l yolo11n.pt ultralytics/assets/bus.jpg
yolo predict model=yolo11n.pt source=ultralytics/assets/bus.jpg device=0

If the weights are missing, restore them from the bundled materials first. The inference log should show CUDA:0 (Orin) and output detection results normally. Results are saved to runs/detect/predict by default, and repeated runs are numbered automatically. This verification generates result images; after use, you can delete the result directory for that run.

Showing only torch.cuda.is_available() = True does not mean actual YOLO inference has passed, nor does it prove that ONNX Runtime is using the GPU.

Common Errors

Cannot uninstall sympy

Symptom

When installing or upgrading frameworks, a message says sympy cannot be uninstalled.

image-20241230111303169

The figure above shows an example of this error in an older environment.

Solution

First confirm whether the command being executed is attempting to reinstall PyTorch or another framework. This tutorial uses a user-level --no-deps installation that reuses existing dependencies and does not require uninstalling the system python3-sympy.

xxxxxxxxxx
python3 -m pip show sympy
python3 -c "import sympy; print(sympy.__version__); print(sympy.__file__)"

If there is indeed a version conflict, determine the required version and installation location from the error before resolving it; do not uninstall the system sympy directly, as this may remove other APT packages along with it.

CSI Camera Cannot Be Accessed

First check whether OpenCV supports GStreamer, whether the camera device exists, and whether it is occupied by another program:

xxxxxxxxxx
python3 -c "import cv2; print(cv2.__version__); print(cv2.__file__); print(cv2.getBuildInformation())" | grep -E 'GStreamer|GUI|site-packages|dist-packages'
ls -l /dev/video*
sudo fuser -v /dev/video0
systemctl status nvargus-daemon --no-pager

/dev/video0 is only a common example; the actual number should be chosen based on the device check results. If GStreamer: YES is shown, there is no need to recompile OpenCV just for YOLO.

Programs such as the ROS 2 camera_csi may be occupying the CSI camera. After confirming the occupying program, exit the corresponding camera application normally before testing YOLO; do not kill unknown processes directly. When connected via SSH without a graphical display environment, the inability to show a window does not by itself indicate a camera driver failure.

The following images are references for an older OpenCV compilation process and environment verification, and are not installation steps for the current JetPack 7.2.1. Do not run install_opencv4.10.0_Jetpack6.1.sh in this environment; only after confirming that GStreamer functionality is missing do you need to prepare a compilation plan matching the current JetPack, CUDA, and Python.

image-20250111110031036

image-20250111115337639

Verifying the Environment

xxxxxxxxxx
python3 -c "import cv2; print(cv2.getBuildInformation())" | grep GStreamer
python3 -c "import ultralytics; print(ultralytics.__version__)"
python3 -c "import torch; print(torch.__version__); print(torch.cuda.is_available())"
python3 -c "import torchvision; print(torchvision.__version__)"
python3 -c "import numpy; print(numpy.__version__)"
jtop

image-20250111115433425

Note: To change opencv_cuda from no to yes, you need to enter the virtual environment and run the following commands:

xxxxxxxxxx
source ~/opencv_cuda/venv/bin/activate
jtop

To exit the virtual environment, type the command deactivate in the terminal.

References

Ultralytics Jetson Deployment Guide

AastaNV/JEP (reference for older compilation scripts)

LiDAR 3D point cloud detection
CLI use

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文