First Time Setup for MicroProjects
MicroProjects are guided, detailed projects that provide you a real data science experience in Python in under and hour!
Step 1: Computer Setup
To complete a MicroProject, you will use the same Python programming language we use in lecture and lab, but you will be completing it using industry-standard tools on your own computer! This includes the use of git, Python, and Visual Studio code -- all on your own computer!
- If you do not already have git, Python, and Visual Studio code installed, follow our Guide: "Setup Your System for Data Science" to get your system set up with these tools!
Step 2: GitHub Repository Setup For STAT 107
Are you enrolled in STAT 107 and doing MicroProjects for extra credit/HCLA?
Make certain to use these instructions -- these instructions will ensure you are set up to earn credit for your work! If you're not in STAT 107, follow in the section below to get full access! :)
Step 2.1: Creating Your Repository (STAT 107)
The MicroProjects will be automatically graded using a GitHub Action. To do this, you'll need a GitHub repository:
- Follow our STAT 107 GitHub Setup Guide to create your repository.
Step 2.2: Adding the microprojects Remote (STAT 107)
The last thing you need to do is add the microprojects remote to your repository!
Using your terminal in the directory of your repository, run the following command:
git remote add microprojects https://github.com/dsdiscovery/microprojects_sp26If you see no output, that means everything worked and you're ready to return the MicroProject page and fetch your first MMicroProject! 🎉
Step 2: GitHub Repository Setup For Open Access DISCOVERY
Are you enrolled in STAT 107 and doing MicroProjects for extra credit/HCLA?
If you are enrolled in STAT 107, do NOT follow these instructions. These instructions create a personal GitHub repository without a connection to STAT 107 and we will not know when you complete a MicroProject and you will not earn any credit for completing the MicroProjects.
Step 2.1: Creating Your Repository
The MicroProjects will be automatically graded using a GitHub Action. You will create your own free personal repository to complete the MicroProjects:
- Follow GitHub's guide: "Creating a new repository"
- Then, follow second GitHub's guide: "Cloning a repository" to create a clone of your repository on your desktop.
Step 2.2: Adding the microprojects Remote (Open Access DISCOVERY)
The last thing you need to do is add the microprojects remote to your repository!
Using your terminal in the directory of your repository, run the following command:
git remote add microprojects https://github.com/dsdiscovery/microprojectsIf you see no output, that means everything worked and you're ready to return the MicroProject page and fetch your first MMicroProject! 🎉
(At this point forward, there is no difference in how you complete the MicroProjects!)
Debugging Common Setup Errors
Error: "fatal: repository not found"
When you run git fetch microprojects and get a fatal: repository not found error, the usual issue is the microprojects remote is not configured correctly.
You can verify If you have the microprojects remote by running:
git remote -vThe command was successful if you see a microprojects entry with the URL https://github.com/dsdiscovery/microprojects. For example, you can see the microprojects entry below:
microprojects https://github.com/dsdiscovery/microprojects (fetch)
microprojects https://github.com/dsdiscovery/microprojects (push)If your entry is incorrect, you can remove the microprojects entry and type it again by running:
git remote remove microprojectsAfter removing it, repeat "Step 3: Adding the microprojects Remote" above.