As we've seen, AI is powered by code--Python code, run in Jupyter Notebooks in our case.
As a best practice, code should reside in a version control system. These systems allow collaboration, enforce good coding practices and foster collaboration and sharing. The most widely used version control system today is git
. Git is free and open source.
In addition to using git
, it is possible to use one of many online git hosting sites. For Practicum AI we use GitHub.com. There are other options, but GitHub is one of the leading online hosting companies and offers educational discounts for students and faculty.
This training will start with some slides which are part of the source repository at: https://ufresearchcomputing.github.io/git-training/#/
After going over the slides, we'll come back to this.
1. Setup: 01_git_setup.md
The 01_git_setup.md page has some basic git and github configuration information.
To learn about setting up your github account to use ssh keys, check out the 01_git setup page.
2. Continue on the 02_exercise.ipynb notebook
Once you have setup your GitHub account and ssh keys, you can continue to the exercise.
There are many great git and github.com tutorials out there. Here are some that I particularly like and have relied on in developing this training.
Source | Notes |
---|---|
Software Carpentry Version Control with Git | This is a popular module in the Software Carpentry curriculum. It is designed to be a 3-hour instructor-lead training module but can be worked through on your own as well. |
GitHub Learning Lab | This site has many lessons that use github.com and automation to walk users through hands-on exercises to learn aspects of git and github.com using the tools. |
try.github.io | More github tutorials |
education.github.com | Information on educational discounts--plans change regularly, check for current benefits. |
classroom.github.com | For instructors wanting to use git in the classroom. Manages individual and group assignments, great tool for the classroom! Also, stickers! |
pages.github.com | Information on using github.com to host web sites. |
bitbucket.org | Github is not the only host of git repositories. Bitbucket is another popular host. |
gitlab.com | Another git hosting option |