TinkerLab
ARTIFACT // SETUP-HAILO10H-AND-RK3588-EDGE-LLM.SH (SH)

Jetson AGX Thor (T5000), Pi 5 AI HAT+ 2 (`Hailo-10H` 8GB) & RK3588 NPU Edge LLM Bootstrap (setup-hailo10h-and-rk3588-edge-llm.sh)

Detects your edge accelerator (Jetson Thor T5000, Raspberry Pi 5 Hailo-10H 8GB NPU, or Rockchip RK3588 rknn-llm), verifies PCIe Gen 3 / NPU frequency governors, and starts an OpenAI/Ollama-compatible local endpoint.

[KEY VERIFIED TAKEAWAY / TL;DR]This reproducible configuration artifact "Jetson AGX Thor (T5000), Pi 5 AI HAT+ 2 (`Hailo-10H` 8GB) & RK3588 NPU Edge LLM Bootstrap" (setup-hailo10h-and-rk3588-edge-llm.sh, SH) is paired with Tinker AI Lab's hardware-verified guide "jetson-agx-thor-t5000-128gb-vs-pi5-ai-hat-plus-2-hailo10h-8gb-and-rk3588-edge-llm-benchmark". It exposes 3 customizable browser variables (EDGE_PLATFORM=hailo10h, EDGE_MODEL_TAG=qwen2.5-instruct:1.5b, API_PORT=11434) with loopback-first security defaults.
03 // MAKERAI Maker / STEM Projects· Verified: 2026-11-04
Browse All 42 Artifacts →
setup-hailo10h-and-rk3588-edge-llm.sh

Jetson AGX Thor (T5000), Pi 5 AI HAT+ 2 (`Hailo-10H` 8GB) & RK3588 NPU Edge LLM Bootstrap

Detects your edge accelerator (Jetson Thor T5000, Raspberry Pi 5 Hailo-10H 8GB NPU, or Rockchip RK3588 rknn-llm), verifies PCIe Gen 3 / NPU frequency governors, and starts an OpenAI/Ollama-compatible local endpoint.

View Paired Guide →
Customizable Variables (Saved in Browser)
UTF-8 Encoded · Live Client-Side Compilation
#!/usr/bin/env bash
# Tinker AI — Next-Gen Edge LLM Bootstrap: Hailo-10H (8GB) / RK3588 NPU / Jetson Thor (Guide #35)
set -euo pipefail

PLATFORM="hailo10h"
MODEL_TAG="qwen2.5-instruct:1.5b"
PORT="11434"

echo "=== [1/3] Auditing Edge Accelerator Platform: $PLATFORM ==="
if [ "$PLATFORM" = "hailo10h" ]; then
  lspci | grep -i "Hailo" || echo "[WARN] Hailo-10H not detected on PCIe bus!"
  hailortcli fw-control identify || true
  echo "=== [2/3] Starting hailo-ollama on Dedicated 8GB NPU RAM (Port $PORT) ==="
  HAILO_OLLAMA_HOST="0.0.0.0:$PORT" hailo-ollama serve &
  sleep 2
  curl -sS "http://127.0.0.1:$PORT/api/tags" || true
elif [ "$PLATFORM" = "rk3588" ]; then
  echo "=== [2/3] Locking RK3588 6 TOPS NPU & DMC Memory Frequency to Performance ==="
  ulimit -l unlimited || true
  cat /sys/kernel/debug/rknpu/version 2>/dev/null || true
  grep -i "Cma" /proc/meminfo || true
  echo "Ready to launch rkllm_server with W4A16 .rkllm model on port $PORT."
else
  echo "=== [2/3] Jetson AGX Thor (T5000 128GB): Locking nvpmodel & jetson_clocks ==="
  sudo nvpmodel -q || true
  sudo jetson_clocks --show || true
  echo "=== [3/3] Launching TensorRT Edge-LLM / vLLM NVFP4 for $MODEL_TAG ==="
fi
PARAMETER SPECIFICATION // 参数化变量规范说明表

Customizable Parameter Reference for setup-hailo10h-and-rk3588-edge-llm.sh

This SH artifact exposes 3 template variables compiled client-side in your browser.

Template TokenParameter DescriptionVerified DefaultExample Format
{{EDGE_PLATFORM}}Target Edge Platform (`hailo10h`, `rk3588`, or `thor`)hailo10hhailo10h
{{EDGE_MODEL_TAG}}Target Edge Model Tagqwen2.5-instruct:1.5bqwen2.5-instruct:1.5b
{{API_PORT}}Edge LLM Service Port1143411434
PAIRED HARDWARE MANIFEST // 配套实测环境与边界记录

Verified Environment for "Next-Gen Edge AI & Robotics Benchmark: NVIDIA Jetson AGX Thor T5000 (128GB · 2070 TFLOPS) vs Raspberry Pi 5 AI HAT+ 2 (Hailo-10H 8GB) & RK3588 NPU"

Tested Hardware & OS

NVIDIA Jetson AGX Thor DevKit (T5000 · 128GB LPDDR5X @ 273 GB/s · 2070 FP4 TFLOPS) | Raspberry Pi 5 (8GB) + AI HAT+ 2 (Hailo-10H 40 TOPS · 8GB Dedicated NPU RAM) | Orange Pi 5 Plus / Rock 5B (RK3588 16GB · 6 TOPS NPU)

Pinned Stack & Model Versions
vLLM 0.8.2 / TensorRT Edge-LLM (JetPack 7.0 NVFP4)hailo-ollama 0.2.1 + HailoRT 5.1.0 (`hailo-h10-all`)RKNN-LLM (`rkllm-runtime`) 1.2.1 (`W4A16` `.rkllm`)
Offline Boundary (100% Air-Gapped Edge / Robot On-Board Execution)

All HEF, RKLLM, and GGUF/NVFP4 weights run locally on battery or 12V/24V robot bus power without cloud connectivity.

Known Operational Limits & Failure Modes
  • The Raspberry Pi AI HAT+ 2 (`Hailo-10H`) has **8GB of dedicated onboard LPDDR4X memory** wired directly to the NPU, meaning models up to `3B INT4` (`Qwen2.5-1.5B` / `Llama-3.2-3B`) must fit inside that 8GB NPU pool and require pre-compiled `.hef` GenAI packages via `hailo-ollama`.
  • Rockchip RK3588’s 6 TOPS NPU shares system LPDDR4X/LPDDR5 (~34 GB/s) and hits a hard ceiling of ~16 tok/s on 1.5B `W4A16` and ~11–12 tok/s on 3B `W4A16`.
DEPLOYMENT CHECKLIST // 配置落地核验步骤

3-Step Verification Checklist After Deploying setup-hailo10h-and-rk3588-edge-llm.sh

  1. Installed `hailo-h10-all` (HailoRT 5.x) and enabled `dtparam=pciex1_gen=3` on Raspberry Pi 5 for AI HAT+ 2 (`Hailo-10H`).
  2. Set `ulimit -l unlimited` and locked NPU + DMC memory governors to `performance` on RK3588 before starting `rkllm_server`.
  3. Selected the target `nvpmodel` power profile (60W battery vs 130W MAXN) and flushed VFS cache on Jetson AGX Thor 128GB.