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.15+ already installed on your machine in order to install TinyGo. We recommend Go v1.17+.

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

brew tap tinygo-org/tools
brew install tinygo

Alternatively, you can download and extract the files manually by downloading this file.

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

$ tinygo version
tinygo version 0.21.0 darwin/amd64 (using go version go1.17 and LLVM version 11.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

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.

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

AVR (e.g. Arduino Uno)

To compile and flash TinyGo programs for AVR based processors such as the original Arduino Uno you must install some extra tools:

brew tap osx-cross/avr
brew install avr-gcc
brew install avrdude

Xtensa ESP32

To compile TinyGo programs for the Xtensa ESP32 based processors from Espressif, you must install some extra tools:

brew tap tasanakorn/homebrew-esp32
brew install xtensa-esp32-elf