> ## Documentation Index
> Fetch the complete documentation index at: https://geniex.aihub.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Python 安装

> 在 Windows ARM64 或 Linux ARM64 上安装 GenieX Python SDK。

GenieX Python SDK 以 ARM64 wheel 形式发布，覆盖 Windows ARM64 与 Linux ARM64。

## **前置条件**

* 骁龙 X 系列芯片（X Elite 或 X2 Elite）。详见[支持的平台](/cn/get-started/platforms)。
* **ARM64 版本的 Python 3.10+**——不支持 x86\_64 / AMD64。

## **通过 pip 安装**

<Tabs>
  <Tab title="Windows ARM64">
    如未安装 Python，请下载 [Python 3.13.3 for ARM64](https://www.python.org/ftp/python/3.13.3/python-3.13.3-arm64.exe)。

    确认安装的是 ARM64 版本 —— **必须输出 `ARM64`**（不能是 `AMD64`）：

    ```powershell theme={"dark"}
    python -c "import platform; print(platform.machine())"
    ```

    创建虚拟环境并从 test PyPI 安装：

    ```powershell theme={"dark"}
    python -m venv geniex-env
    .\geniex-env\Scripts\Activate.ps1
    pip install -U -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple geniex
    ```

    这将从 [test PyPI](https://test.pypi.org/project/geniex/) 拉取 Python 包。
  </Tab>

  <Tab title="Linux ARM64">
    高通嵌入式 Linux（Yocto）已预装 Python。验证：

    ```bash theme={"dark"}
    python3 --version
    ```

    直接 pip install：

    ```bash theme={"dark"}
    python3 -m pip install -U -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple geniex
    ```

    这将从 [test PyPI](https://test.pypi.org/project/geniex/) 拉取 Python 包，并自动获取 Linux ARM64 SDK 库。

    <Note>
      如设备未预装 Python，请参考常见问题中的[如何在 Linux ARM64 设备上安装 Python？](/cn/resources/faq#如何在-linux-arm64-设备上安装-python)（已验证可用的 Miniconda 流程，覆盖 Qualcomm Yocto 与 Ubuntu ARM64）。
    </Note>
  </Tab>
</Tabs>

## **验证**

```python theme={"dark"}
import geniex
print(geniex.version())
```

现在跳转到[快速入门](/cn/run/python/quickstart)。

<br />

<div class="feedback-wrapper">
  <span class="feedback-label">Was this page helpful?</span>

  <div class="feedback-toggle">
    <input type="radio" name="feedback" id="feedback-yes" class="feedback-input" />

    <label for="feedback-yes" class="feedback-button">
      <img src="https://mintcdn.com/qualcomm-0801e48b/VijZ6eXFSGIGNc9Z/Images/FeedBack/thumbs-up.svg?fit=max&auto=format&n=VijZ6eXFSGIGNc9Z&q=85&s=9fa1e132909ee8667d02f775cd8bc108" alt="Thumbs up" class="feedback-icon" noZoom width="14" height="14" data-path="Images/FeedBack/thumbs-up.svg" />

      Yes
    </label>

    <input type="radio" name="feedback" id="feedback-no" class="feedback-input" />

    <label for="feedback-no" class="feedback-button">
      <img src="https://mintcdn.com/qualcomm-0801e48b/VijZ6eXFSGIGNc9Z/Images/FeedBack/thumbs-down.svg?fit=max&auto=format&n=VijZ6eXFSGIGNc9Z&q=85&s=7f5f8865b502b5262849a700e6989278" alt="Thumbs down" class="feedback-icon" noZoom width="14" height="14" data-path="Images/FeedBack/thumbs-down.svg" />

      No
    </label>
  </div>
</div>
