# Setup

This section provides instructions to quickly install and launch QAIRT Visualizer.

## Machine requirements

- QAIRT Visualizer supports the following operating systems:

    - Windows-x86 (10+)
    - Windows-arm64 (10+)
    - Mac-arm64 (14+)
    - Linux (Ubuntu 22.04)
- Python (3.10+)

Note

For Windows-arm64, use Python/Pip (AMD64), which comes by default from the Microsoft App Store.

## Install

Run the following command to install the QAIRT Visualizer tool.

pip install qairt-visualizer
    Copy to clipboard

Warning

If SSL errors occur while running any of the commands below, errors can be disabled with `$env:REQUEST_VERIFY = "false"` or `set REQUEST_VERIFY=false` for Windows devices, or with `export REQUEST_VERIFY=false` for Linux/Unix.

## Set log directory

By default, the directory for logs is set to `~/.qairt_visualizer/logs`.

Tip

Users can change this by setting the `QAIRT_VISUALIZER_LOG_DIRECTORY` path.

## Uninstall

Run the following command to uninstall the QAIRT Visualizer tool.

pip uninstall qairt-visualizer
    Copy to clipboard

Due to post install additions after `pip install` pip will warn that some files will remain after uninstall.

- To clear all QAIRT Visualizer content from the system, use:

rm -rf <path_to_python>/site_packages/qairt_visualizer
        Copy to clipboard
- To remove cache captured for items such as logs, use:

rm -rf ~/.qairt_visualizer or <path_to_logs> if QAIRT_VISUALIZER_LOG_DIRECTORY is set
        Copy to clipboard

## Next steps: review application components

See [Application Components](https://docs.qualcomm.com/doc/80-87189-1/topic/application-components.html#app-components) to learn more about application components.

Last Published: Aug 19, 2026

[Previous Topic
Getting started](https://docs.qualcomm.com/bundle/publicresource/80-87189-1/topics/getting-started.md) [Next Topic
Application Components](https://docs.qualcomm.com/bundle/publicresource/80-87189-1/topics/application-components.md)