macOS install guide

This page has information on how to install and use TinyGo on macOS. If you wish to build TinyGo from source, for example if you intend to contribute to the project, please take a look here.

You must have Go v1.18+ already installed on your machine in order to install TinyGo.

You can use Homebrew to install TinyGo using the following commands:

brew tap tinygo-org/tools
brew install tinygo

Alternative installation

Download this file. Then, run the following commands:

tar xvzf tinygo-0.27.0.darwin-amd64.tar.gz
export PATH=<extract location>/tinygo/bin:$PATH

You can test that the installation is working properly by running this code which should display the version number:

$ tinygo version
tinygo version 0.27.0 darwin/amd64 (using go version go1.20 and LLVM version 15.0.0)

If you are only interested in compiling TinyGo code for WebAssembly then you are done with the installation.

Otherwise, please continue with the installation of the additional requirements for your desired microcontroller.

Additional Requirements for Microcontrollers

If you are only interested in compiling TinyGo code for ARM microcontrollers then you are now done with the installation.

Some boards require a special flashing tool for that particular chip, like openocd or nrfjprog. See the documentation page for your board as listed here to see which flashing tool is required for your target board.

AVR (e.g. Arduino Uno)

To flash TinyGo programs for AVR based processors such as the original Arduino Uno you must install avrdude:

brew install avrdude
Last modified February 12, 2023: all: update to TinyGo 0.27.0 (699081d)