Linux (Docker) 安装

Linux Docker 路径通过 Linux ARM64 容器镜像运行，并支持 NPU 访问（适用于跃龙 QCS9075 等 IoT 平台）。

这是容器化路径。若你更希望在宿主机上直接安装 geniex 而不使用 Docker，请参见 CLI 安装 → Linux ARM64 (Native)。

前置条件

安装了 Docker 的 Linux ARM64 主机——若尚未安装 Docker，请参照 Docker 的 Ubuntu 安装指南。
跃龙 IoT 芯片——详见支持的平台。
拥有以下任一镜像仓库读权限的凭据。

安装宿主机依赖

容器通过 -v /usr/lib:/opt/qcom-lib:ro 挂载的宿主机高通驱动库来访问 NPU。请在执行 docker run 之前，在宿主机上安装这些库——参见 CLI 安装 → 安装宿主机依赖。

拉取镜像

镜像同时发布到两个仓库——选择你有权限的一个，设置 IMAGE 后再拉取：

bash

# Option A — Docker Hub (公开，无需登录):
IMAGE=docker.io/qualcomm/geniex:latest

# Option B — Qualcomm Container Registry:
docker login docker-registry.qualcomm.com -u '$app' -p GB2S6KXMJXTPV8VHNFNS7Q6LVH75LOOBTLT8D723WUX6PSFZMTX95GIQG4EFWH5C021ONZ5763VI9IDHU96Q7VAZJ2830CLX3NPI6STQOJWRYXLLA2ZYTL1S
IMAGE=docker-registry.qualcomm.com/qcom-ai-hub/geniex-cli:latest

docker pull "$IMAGE"

若 docker login 失败或 docker pull 返回 permission denied ... /var/run/docker.sock，参见故障排查 → Linux 了解凭据与 docker 组的修复方法。

交互式运行

进入容器内交互式 shell：

bash

docker run -it --rm --privileged \
  -v "$PWD/data:/data" \
  -v /usr/lib:/opt/qcom-lib:ro \
  "$IMAGE"

验证

然后在容器 shell 中运行测试命令：

bash

geniex --help

NPU 访问需要 --privileged 标志。

服务器模式参见本地服务器。

CLI

完整 CLI Docker 安装指南，参见 CLI 安装 — Linux ARM64 (Docker)。

Python

完整 Python 安装指南（原生 Linux ARM64），参见 Python 安装 — Linux ARM64。 Python SDK 既可安装在 Docker 容器内，也可直接安装在 Linux ARM64 主机上。原生安装指南请参见 Linux ARM64 标签页。

Was this page helpful?

Yes

开始使用

运行

资源

前置条件

安装宿主机依赖

拉取镜像

交互式运行

验证

CLI

Python

​前置条件

​安装宿主机依赖

​拉取镜像

​交互式运行

​验证

​CLI

​Python

前置条件

安装宿主机依赖

拉取镜像

交互式运行

验证

CLI

Python