Most ICT Learning Sciences apps run on a mix of python and node-based microservices.
Currently, the supported way to get the development envs working is to run them all in Rosetta, mac's x86 emulation env.
To make this actually work, you must make sure XCode and Rosetta are installed before you start installing any other dev tools--brew and pyenv in particular.
- Setup a copy of Terminal that runs in x86 by default, following these instructions:
https://osxdaily.com/2020/11/18/how-run-homebrew-x86-terminal-apple-silicon-mac/
...you will use this x86 terminal for running all dev envs and all commands below
-
Install XCode from the App Store. This must be done first because you need dev tools
-
Make sure dev tools are installed. Do:
sudo xcode-select --install
- In terminal, install brew with:
# this is from https://brew.sh/
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Once
brew
is installed, you can use it to installpyenv
, e.g.
brew install pyenv
...and node and any other dev tools that need to run in x86/rosetta. As long as you run everything from the x86 terminal, the installs will be x86
- Complete setup of pyenv by configuring your path as described here, and then restart terminal for new settings to take effect.
- Docker [required]: https://docs.docker.com/docker-for-mac/install/ (install the M1 version)
- Git LFS [required]:
brew install git-lfs
- VSCode [optional]: https://code.visualstudio.com/docs/?dv=osx