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

# Build the QIR SDK

The following sections explain how to build the QIR SDK.

<Warning>
  **Warning**

  It's not recommended to rebuild the QIR SDK, as the build process is complex for non-professionals. Build the QIR SDK ONLY if you understand the process and have the following needs:

  * Build an image for the device which doesn't have a prebuilt image, for example, the Qualcomm<sup>®</sup> IQ-8 Evaluation Kit. For details, see [Supported platforms](./qir-sdk-overview#supported-platforms).
  * Add new features to the QIR SDK.
  * Change the content of the target image.
  * Fix bugs in the QIR SDK.
  * Optimize the performance of the QIR SDK.
  * Change the version of certain components.
</Warning>

## Choose the best method for you

To synchronize and build the QIR SDK and robotics image, choose any of the following options:

* Use the [GitHub workflow](./build-with-git-hub-workflow) on your PC **(Recommended)**.
* Use the [Qualcomm Software Center (QSC) Launcher GUI](./build-with-qsc-launcher).
* Use the [Qualcomm Software Center command line interface (QSC-CLI)](./build-with-qsc-cli).

To build the robotics image only, use the prebuilt eSDK in [Supported platforms](./qir-sdk-overview#supported-platforms) using the following method:

[Build the robotics image with the prebuilt robotics eSDK](./build-the-robotics-image-with-the-prebuilt-robotics-esdk)

## Host computer requirements

The following requirements apply to your host computer for compiling the QIR SDK:

| Category     | Requirement                                                                          |
| :----------- | :----------------------------------------------------------------------------------- |
| **Hardware** | x86 machine with Quad-core CPU (for example, Intel i7-2600 at 3.4 GHz or equivalent) |
|              | ≥ 450 GB free disk space (swap partition ≥ 32 GB)                                    |
|              | ≥ 16 GB RAM                                                                          |
| **Software** | Git 1.8.3.1 or later                                                                 |
|              | Tar 1.28 or later                                                                    |
|              | Python 3.10.2 or later                                                               |
|              | GCC 10.1 or later                                                                    |
|              | GNU Make 4.0 or later                                                                |
|              | Kas 4.8 or later                                                                     |
|              | `sudo` permission (required for a few commands)                                      |

<Note>
  **Note**

  * To set up a virtual machine (VM) running Ubuntu on Microsoft Windows or Apple® macOS®, see [Qualcomm Linux Virtual Machine Setup Guide](../../Key-Documents/Virtual-Machine-Setup/virtual-machine-setup-overview).
  * Code compilation on a VM is a slow process and may take a few hours. Qualcomm recommends using an Ubuntu host computer for compilation.
</Note>