Watch instruction videos at YouTube

To be able to use this repository and handover your code, you need to have remote access to Github.

1. Install Git

   Make sure you select "Checkout as-is, commit Unix-style line endings" during the installation process.

   • Git for Windows

   • Git for Mac

2. Install GitHub CLI (MacOS and Ubuntu)

   brew install gh

   Installation instructions on Ubuntu

   Installation instructions on Ubuntu

   NOTE
   Although you could download and install GitHub CLI for Windows, I don't recommend it since it does not properly work in Git Bash.

3. Install Homebrew (MacOS only)

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4. Install iterm2 (MacOS)

   brew install iterm2

5. Install zsh (MacOS and Ubuntu)

   • Install zsh on MacOS using

     brew install zsh

     In Ubuntu

     sudo apt install zsh

   • Add iTerm2 path to zsh profile

     echo "eval \"\$(homebrew/bin/brew shellenv)\"" >> ~/.zshrc

   • (Optional) Install oh-my-zsh (MacOS and Ubuntu)

     sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

6. Create a fork of this repository

   Create a fork of AlxcNL/MakeAIWork2 in GitHub or use the GitHub Client by entering the following commands in your terminal

   gh repo fork https://github.com/AlxcNL/MakeAIWork2

7. Clone your fork If you installed the GitHub client, you can authenticate with the following command in the terminal

   gh repo clone [email protected]:{your_github_username}/MakeAIWork2.git

   otherwise enter the following command in your (git)bash shell after replacing {your_github_username} with your GitHub username.

   git clone [email protected]:{your_github_username}/MakeAIWork2.git

8. Configure git

   In order to commit and push your changes, you need identitify yourself.

   Open a (git)bash, enter directory MakeAIWork2 and run:

   install/git_config.sh {your_github_username} {[email protected]}

   This script will also set the pull policy to rebase.

9. Add upstream to original remote repository

   To be able To be able to fetch and merge changes from this repository using (bash) commands, you need to have a (second) upstream.
   If you used the GitHub client to create the fork you can skip this step, otherwise enter the following commands

   git remote add AlxcNL https://github.com/AlxcNL/MakeAIWork2

10. Keep your fork repository up-todate by regularly pulling changes from the original remote repository into your local fork..

     git pull AlxcNL main

    and push the changes to you remote fork

    git push

Install python

1. Install python

2. Install Miniconda (MacOS and Linux)

   Download and install Miniconda

3. Windows

   install/init_git_bash_profile.sh

4. Create virtual Python environment

   install/create_virtual_env.sh

5. Install Python libraries

   install/install_requirements.sh

1. Install Visual Studio Code

2. Enable VSCode to be opened from the command line (macOS only)

   In VSCode, open the Command Palette and type 'shell command' in order to select the Shell command: Install ‘code’ command in PATH

3. Start vscode with command from current directory

   Start a (git) bash shell and enter directory MakeAIWork2, from there use the command code to start vscode.

   cd MakeAIWork2
   code .

4. Install the Python extension

   Download and install the Python extension

5. Install the Git Bash plugin (Windows)

6. Install Live Share

   Follow the instructions at Collaborate with Live Share

How to Use Linux Terminal in Windows 10
Jupyter
Running GUI's with Docker on OS X