Installation

In Windows

MSI Installer (recommended)

Download -win-x64-installer.msi from release page and install or update.

Chocolatey

If you have Chocolatey installed, you can install Heta compiler using the following commands:

choco install heta-compiler

Or install a specific version:

choco install heta-compiler --version=0.9.5

Update Heta compiler

choco upgrade heta-compiler

Uninstall Heta compiler

choco uninstall heta-compiler

In Linux

Ubuntu/Debian package (recommended)

Install/Update as .deb package

wget https://github.com/hetalang/heta-compiler/releases/latest/download/heta-compiler-x64.deb
sudo dpkg -i heta-compiler-x64.deb

Uninstall .deb package

sudo dpkg -r heta-compiler

Other Linux systems

Install/Update for all users (requires sudo privileges)

sudo wget -O /usr/local/bin/heta https://github.com/hetalang/heta-compiler/releases/latest/download/heta-compiler-linux-x64 && sudo chmod +x /usr/local/bin/heta

Uninstall for all users

sudo rm /usr/local/bin/heta

Install/Update for single user without sudo previleges

mkdir -p ~/bin
wget -O ~/bin/heta https://github.com/hetalang/heta-compiler/releases/latest/download/heta-compiler-linux-x64
chmod +x ~/bin/heta
echo "export PATH=$PATH:~/bin" >> ~/.bashrc
source ~/.bashrc

Uninstall for single user

rm ~/bin/heta

In macOS

Standalone packages and the Homebrew formula are available for Apple Silicon (arm64) only. On Intel Macs, install the npm package as described above.

Homebrew package manager (recommended)

If you have Homebrew installed, you can install Heta compiler using the following commands:

brew tap hetalang/heta-compiler
brew install heta-compiler

Update Heta compiler

brew update
brew upgrade heta-compiler

Uninstall Heta compiler

brew uninstall heta-compiler

Manual installation on Apple Silicon

Install/Update for all users (requires sudo privileges)

sudo wget -O /usr/local/bin/heta https://github.com/hetalang/heta-compiler/releases/latest/download/heta-compiler-macos-arm64 && sudo chmod +x /usr/local/bin/heta

Uninstall for all users

sudo rm /usr/local/bin/heta

Install/Update for single user without sudo previleges

mkdir -p ~/bin
wget -O ~/bin/heta https://github.com/hetalang/heta-compiler/releases/latest/download/heta-compiler-macos-arm64
chmod +x ~/bin/heta
echo "export PATH=$PATH:~/bin" >> ~/.bashrc
source ~/.bashrc

Uninstall for single user

rm ~/bin/heta

Troubleshooting:

In some cases you may need to install Rosetta to run the tool on MacOS. To install Rosetta, run the following command in the terminal:

softwareupdate --install-rosetta

In NodeJS environment

NodeJS must be installed prior to Heta compiler installation. The recommended version is NodeJS v24.

The next steps should be taken using console (shell): cmd, PowerShell, sh, bash depending on your operating system.

1. Check Node version.

   node -v
   # must be v18.0.0 or newer

2. The latest stable version of Heta compiler can be installed from npm

   npm i -g heta-compiler

   OR The development version can be installed directly from GitHub

   npm i -g git+https://github.com/hetalang/heta-compiler.git