Building a Portfolio & GitHub Basics

You’re at the perfect stage in Python for Beginners — you’ve built real projects (calculator, games, to-do app, chatbot, expense tracker), and now it’s time to showcase them like a pro. A strong portfolio + polished GitHub is your ticket to standing out for entry-level Python roles in Nigeria (fintech startups in Lagos/Abuja) or remote global gigs (Upwork, remote companies paying in USD).

In 2026, recruiters spend seconds scanning GitHub — make yours scream “hire me” with clean repos, good READMEs, and a standout profile. No need for fancy paid tools — GitHub is free and powerful.

Step 1: GitHub Basics – Get Set Up (If Not Already)

  1. Create Account (if new): Go to github.com → Sign up with email (use a professional one like jeffmoniac.dev@gmail.com). Verify email.
  2. Install Git (local version control – required for pushing code):
    • Windows: Download from git-scm.com → Install (use defaults).
    • macOS/Linux: Usually pre-installed; check with git –version in terminal. If not: brew install git (Mac) or sudo apt install git (Ubuntu).
  3. Configure Git (one-time setup in terminal/VS Code terminal):Bashgit config --global user.name "Jeffmoniac" git config --global user.email "your.email@example.com"
  4. Create Your First Repo (for a project):
    • In VS Code: Open your project folder → Terminal → New Terminal.
    • Run:Bashgit init git add . git commit -m "Initial commit: My first Python to-do list app"
    • On GitHub.com: Click “+” → New repository → Name it e.g. “python-todo-app” → Create (don’t add README yet).
    • Link & push:Bashgit remote add origin https://github.com/IbekweJefferson/python-todo-app.git git branch -M main git push -u origin main
    (Use GitHub Desktop app if terminal scares you — super beginner-friendly.)

Repeat for each project. Aim for 5+ repos from our course.

Step 2: Make Each Repo Shine – Write Killer READMEs

Every project needs a README.md (Markdown file) — it’s the first thing people see.

Best practices for beginners (2026 style):

  • Title & Badges (optional fun): Project name big, add shields.io badges (e.g., Python version, stars).
  • Description: 2–4 sentences — what it does, why you built it, tech used (Python only for now).
  • Features: Bullet list (e.g., • User input for tasks • Save/load from file • Error handling).
  • Installation/Run: Step-by-step code blocks:Bashgit clone https://github.com/IbekweJefferson/python-todo-app.git cd python-todo-app python todo.py
  • Screenshots/GIFs: Add images (upload to repo or use imgur) — e.g., terminal output or app in action.
  • Usage Examples: Code snippets.
  • License: Add MIT (simple permissive) via GitHub → Add file → Choose license.

Example simple README structure:

Markdown

# Python To-Do List App

A beginner Python CLI tool to manage daily tasks – built during my Python course!

## Features
- Add, view, remove tasks
- Save tasks to file (persistent!)
- Basic error handling

## How to Run
```bash
python todo.py

Demo

Made with ❤️ in Port Harcourt

text

Pin your top 4–6 repos on your profile (Overview tab → Customize pins).

Here are some inspiring README examples for clean project pages:

<grok-card data-id="6d7098" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

<grok-card data-id="5f2063" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

### Step 3: Level Up Your GitHub Profile (Make It Your Mini-Portfolio)
GitHub auto-shows a special README on your profile page if you create a repo named exactly **your-username** (IbekweJefferson/IbekweJefferson).

1. Create repo: github.com/new → Name: IbekweJefferson (must match username) → Add README → Create.
2. Edit README.md with cool stuff:
   - Greeting: "Hey! I'm Jeffmoniac, aspiring Python dev from Port Harcourt 🌴"
   - About: Short bio + skills (Python, Git, VS Code...)
   - Pinned projects section (links to your repos)
   - Stats: Add github-readme-stats (copy-paste code from github.com/anuraghazra/github-readme-stats)
   - Connect: Links to LinkedIn, X (@IbekweJefferson), email
   - Fun: Emojis, ASCII art, or quote

Examples of attractive profile READMEs:

<grok-card data-id="877bd5" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

<grok-card data-id="b88c59" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

<grok-card data-id="a76a4f" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

Tools to generate: rahuldkjain.github.io/gh-profile-readme-generator (free, copy-paste code).

### Step 4: Bonus – Simple Portfolio Website (Free via GitHub Pages)
Host a one-page site linking your projects:
1. Create repo: username.github.io (e.g., IbekweJefferson.github.io)
2. Add index.html with basic HTML/CSS (or use templates from html5up.net)
3. It auto-lives at https://IbekweJefferson.github.io

Quick examples of simple GitHub Pages portfolios:

<grok-card data-id="269595" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

<grok-card data-id="3a2c4e" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

<grok-card data-id="ba341a" data-type="image_card" data-plain-type="render_searched_image"  data-arg-size="LARGE" ></grok-card>

Link this site in your LinkedIn/X bio + job apps.

You've got the skills — now showcase them! Start by pushing one project today (e.g., the to-do app) and share the repo link here. I'll review it and give tips.  

Next in the course: Intro to OOP basics or more projects? Or want help with your first README draft? Let's get that portfolio live! 🐍💪
Quizzes
Previous Lesson
Back to Lesson
Next Quiz