01 - Onboarding

In this section, you will learn how to set up the development environment that will be used throughout the rest of the workshop.

The first thing you will need is a free, personal GitHub account. If you have an account that is managed by your organization, it might not work because your administrator may have disabled some features that we will be using. But if you don't have a free, personal GitHub account, you can create one. Again, they're free!

Go to the following URL which is the repository for the workshop materials: https://bit.ly/py_ai_quickstart.

Click the Fork button in the upper right of the page. This will create a copy of the repository in your GitHub account.

Go to the forked repository in your account and click the green Code button. Click the Codespaces tab and then the plus icon to create a new Codespace. This will open a new browser tab with Visual Studio Code running in the browser.

A little bit about GitHub Codespaces. This is a cloud-based environment where you will be able to write and run all of the demos and exercises for the workshop. You don't need to download or install anything to your local machine. Everything runs in the cloud and will be accessible from the browser. And it's also free to get started. You can use Codespaces for free, up to 60 hours per month. And this will be more than enough for this workshop.

By now, you should be able to see the GitHub Codespace in your browser. Before configuring the Codespace, let's set a value that will help you conserve your free hours. Go back to the repository page in GitHub and click your profile picture in the upper right corner. Click on Settings and then on Codespaces under Code, planning, and automation in the left sidebar. Scroll down the Default idle timeout. This is the amount of time that your Codespace will remain active when you are not using it. By default it is set to 30 minutes, but you can change it to any value between 5 and 240 minutes. I find 5 minutes to be a bit limiting so I like to leave it at 10 minutes. Be sure to click the Save button after changing the value.

Go back to the Codespace. You can also manually shut the Codespace down when you are done using it. Click the button in the lower left corner of the Codespace that includes the generated name of the Codespace. This will open up the Command Pallette in the center of the window. Click on Stop Current Codespace and the Codespace will save its state and immediately shut down.