π· WEEK 1 Lesson 6
Title: Git & GitHub Workflow + Mini Engineering Setup Project
Lesson Objective
By the end of this lesson, learners will:
Understand why version control is critical in AI engineering
Understand repositories
Make commits properly
Understand branches
Follow basic collaboration workflow
Structure AI projects professionally
Set up their first proper AI engineering repository
This lesson builds professional discipline.
1. Why Version Control Matters
Imagine:
You trained a model.
It worked perfectly.
You changed something.
Accuracy dropped.
You donβt remember what you changed.
Without version control β youβre guessing.
With Git β you can:
Track changes
Revert mistakes
Compare versions
Collaborate safely
Maintain production systems
AI projects evolve constantly.
Version control is not optional.
It is engineering survival.
2. What Is Git?
Git is a version control system.
It tracks:
File changes
Code history
Who changed what
When it was changed
Think of it as:
Time travel for your code.
3. What Is GitHub?
GitHub is a platform that hosts Git repositories online.
It allows:
Backup
Collaboration
Code review
Project visibility
Portfolio building
Professional AI engineers always maintain clean public or private repositories.
4. Core Concepts
Repository (Repo)
A repository is:
A project folder tracked by Git.
It contains:
Code
Data scripts
README file
Project documentation.
Commit:
A commit is:
A snapshot of your project at a specific time.
Good engineers write meaningful commit messages.
Bad:
update
Good:
Refactored preprocessing function for missing values
Commit messages should explain WHY, not just WHAT.
Branches:
Branches allow you to:
Work on features separately
Experiment safely
Avoid breaking main code
Common workflow:
main β stable production code
feature-branch β development work
When ready: Merge feature branch into main.
5. Basic Collaboration Workflow
Professional workflow:
Clone repository
Create branch
Make changes
Commit changes
Push branch
Open pull request
Review & merge.
Even if working alone, practice this workflow.
It builds industry readiness.
6. Structuring AI Projects Properly
Do NOT dump everything in one folder.
Professional structure:
ai-project/
β
βββ data/
β βββ raw/
β βββ processed/
β
βββ notebooks/
β
βββ src/
β βββ data_loader.py
β βββ preprocess.py
β βββ train.py
β βββ evaluate.py
β
βββ models/
β
βββ requirements.txt
βββ README.md
βββ .gitignore
Why this matters:
Clean separation
Easier debugging
Scalable system
Production readiness
This is how real AI systems are structured.s.
7. The README File β Your Engineering Identity
Every repository must have:
README.md
It should explain:
Problem statement
Dataset
How to install dependencies
How to run the project
Expected output
This is your professional signature.
Recruiters read README files.
Mini Engineering Setup Project
Your Assignment:
1οΈβ£ Create a new GitHub repository named:
ai-engineering-foundations (or create any name in this same format)
2οΈβ£ Structure it properly:
src/
data/
README.md
requirements.txt
3οΈβ£ Add:
A simple NumPy script from Lesson 4
A short README explaining the project
4οΈβ£ Make at least:
3 meaningful commits
Example commit structure:
Initial project setup
Added NumPy matrix computation
Added README documentation
5οΈβ£ Push to GitHub.
Week 1 β Lesson 6 Outcome
Students now:
β Understand version control
β Understand repositories
β Understand commits & branches
β Follow basic collaboration workflow
β Structure AI projects professionally
β Publish first engineering repository
Week 1 Complete
Students now have:
Engineering mindset
Linear algebra intuition
Probability intuition
Python discipline
Data structure awareness
Version control workflow
This is now a solid professional foundation for learners.
Next:
π· Week 2 β Data Engineering Lite & Model Lifecycle
Powered by Soft AI Africa | Training the Next Generation of AI Leaders in Africa.