Install the Vega SDK

Vega Developer Tools (VDT) is a comprehensive suite of tools, SDK, libraries, and components used for building apps for Vega OS devices. This includes Vega Studio, an integrated development environment (IDE) for app development, debugging, performance analysis, and optimization. If you have VS Code installed, the installer sets up Vega Studio automatically. You can also install Vega Studio later by following the instructions in Set Up and Use Vega Studio.

Prerequisites

Before installing VDT, make sure your system meets these requirements:

Disk space: 20 GB available for VDT installation and development environment

Supported operating systems: macOS 10.15+ or Ubuntu 20.04+

Recommended: Download and install Visual Studio (VS Code) for Vega Studio integration

Required dependencies

Install the required dependencies for your operating system:

• macOS Dependencies
• Ubuntu Dependencies

   [[ $(arch) == "arm64" ]] && softwareupdate --install-rosetta --agree-to-license; brew update && brew install binutils coreutils gawk findutils grep jq lz4 gnu-sed watchman

   sudo apt remove curl
   sudo apt install curl

   (dpkg -l | grep -q lz4 || sudo apt install -y lz4) && \
   sudo add-apt-repository -y ppa:deadsnakes/ppa && \
   sudo apt update && \
   (dpkg -l | grep -q libpython3.8-dev || sudo apt install -y libpython3.8-dev)

Install Vega SDK

Close VS Code before installing the SDK. If you see an 'Electron quit unexpectedly' message during or after installation, this can occur when VS Code is running during installation or when installing over an existing Vega version. While this message doesn't affect the installation and you can ignore it, you must restart VS Code afterward.

1. Run the Vega installation script in your terminal:

   Copy code Copied to clipboard.

   curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash && source ~/vega/env
   

2. The installer prompts you with the following options:

   • Component installation directory: Press Enter to use the default (~/vega/sdk) or specify a custom path.

   • Install latest Vega SDK: Press Enter to install the latest SDK version (recommended for new users).

   • Install Vega Studio into Visual Studio Code: Press Enter to install the Vega Studio extension for VS Code (recommended).

   The installation script automatically:

   • Installs the Vega CLI to ~/vega/bin

   • Downloads and installs the Vega SDK

   • Installs the Vega Virtual Device (VVD) for testing

   • Installs the Vega Studio extension for VS Code (if selected)

   • Configures your shell environment by modifying .bashrc, .zshrc, .bash_profile, .zprofile, and/or .profile

3. Wait for the installation to complete.

4. Verify the installation by checking the Vega CLI version:

   Copy code Copied to clipboard.

   vega --version
   

   You should see output displaying both the Active SDK Version and Vega CLI Version.

   Example:

   Active SDK Version: [version number]

   Vega CLI Version: [version number]

   The Active SDK Version indicates which SDK you're using for development, while the Vega CLI Version shows the version of the command-line tool that manages your SDK installations.

Manage additional SDK versions

After the initial installation, you can install additional SDK versions or switch between versions:

To install a specific SDK version:

vega sdk install <version>

To list all installed SDK versions:

vega sdk list-installed

To see all available SDK versions to install:

vega sdk list-remote

Restart VS Code after Vega SDK installation

If VS Code was running during the Vega SDK installation, reload the app to recognize the Vega Studio extension:

1. Open the VS Code Command Palette:

   macOS: Press Cmd+Shift+P

   Linux: Press Ctrl+Shift+P

2. Enter Reload Window and press Enter.

   VS Code reloads and recognizes the Vega Studio extension.

Next steps

After installing Vega Developer Tools, choose your development approach:

For beginners:

• Start with the Build a Hello World App to learn Vega development basics.

For experienced developers:

• Vega Studio: If you installed Vega Studio, begin with Build an App Using Vega Studio.

  If you didn't install Vega Studio: Set up the development environment by following the instructions in Set Up and Use Vega Studio.

• Vega CLI: For command-line development, see Build an App Using Vega CLI.

• Vega SDK Manager: For command-line development, see Manage Your SDK Versions.

Need help?

• Visit Fix Vega SDK Installation Issues.
• Post an issue in Developer Forum.

• Next – Build an App

Last updated: Jan 07, 2026