Standard Setup of Toolchain for Mac OS¶
ESP-IDF will use the version of Python installed by default on macOS.
sudo easy_install pip
install CMake & Ninja build:
If an error like this is shown during any step:
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
Then you will need to install the XCode command line tools to continue. You can install these by running
Installing and setting up Python 3 as default¶
Basing on macOS Catalina 10.15 release notes, use of Python 2.7 is not recommended and Python 2.7 will not be included by default in future versions of macOS. Check what Python you currently have:
If the output is like
Python 2.7.17, your default interpreter is Python 2.7. If so, also check if Python 3 isn’t already installed on your computer:
If above command returns an error, it means Python 3 is not installed.
Below is an overview of steps to install Python 3 and making it default interpreter.
Installing with HomeBrew can be done as follows:brew install python3 ln -s /usr/local/bin/python3.8 /usr/local/bin/python
Adjust above directory name
/usr/local/bin/python3.8to point where Python 3 has been installed. To check this directory you can run
which -a python3.
If you have MacPorts, you can run:sudo port install python38 sudo port select --set python python38
Now open a new terminal session to verify what python is running by default:
If the output is similar to
Python 3.8.5, your installation has been done successfully.
This is system-wide change which may affect all of the applications.
Python 2 deprecation¶
Python 2 reached its end of life and support for it in ESP-IDF will be removed soon. Please install Python 3.6 or higher. Instructions for macOS are listed above.