Created
Sep 26, 2025 2:28 AM
Tags
I'll walk you through the step-by-step process to upload your project to GitHub. Here's the complete guide:
π Step-by-Step Guide to Upload to GitHub
Option A: Using Terminal/Command Line (Recommended)
Step 1: Navigate to Your Project Directory
cd /Users/teslim/TeslimWorkSpace/PorfolioRepo/25-Portfolio-aihero/project
Step 2: Initialize Git Repository
git init
Step 3: Create the README.md File
Create a new file called README.md in your project folder and paste the README content I provided earlier.
Step 4: Add All Files to Git
git add .
Step 5: Make Your First Commit
git commit -m "Initial commit: AI Mail Agent - Day 1 Complete"
Step 6: Create Repository on GitHub
- Go to https://github.com/TeslimAdeyanju
- Click the green "New" button (or "+" in top right β "New repository")
- Repository name:
ai-mail-agentor7-day-ai-agent-course - Description: "7-Day AI Agent Development Course - Building an intelligent mail agent from GitHub repositories"
- Keep it Public (for portfolio visibility)
- Don't initialize with README (since you already have one)
- Click "Create repository"
Step 7: Connect Local Repository to GitHub
git remote add origin <https://github.com/TeslimAdeyanju/ai-mail-agent.git>
git branch -M main
Step 8: Push to GitHub
git push -u origin main
Option B: Using GitHub Desktop (GUI Method)
Step 1: Download GitHub Desktop
- Download from: https://desktop.github.com/
- Install and sign in with your GitHub account
Step 2: Create Repository
- Click "Create a New Repository on your hard drive"
- Name:
ai-mail-agent - Local path: Choose your project folder
- Check "Initialize this repository with a README"
- Click "Create Repository"
Step 3: Add Your Files
- Copy your notebook files and README.md to the repository folder
- GitHub Desktop will automatically detect the changes
- Add a commit message: "Initial commit: AI Mail Agent - Day 1 Complete"
- Click "Commit to main"
Step 4: Publish to GitHub
- Click "Publish repository"
- Keep repository name as
ai-mail-agent - Add description: "7-Day AI Agent Development Course"
- Keep it Public
- Click "Publish Repository"
Option C: Using VS Code (If you have GitHub extension)
Step 1: Open VS Code in Project Folder
cd /Users/teslim/TeslimWorkSpace/PorfolioRepo/25-Portfolio-aihero/project
code .
Step 2: Initialize Git
- Open VS Code terminal (Terminal β New Terminal)
- Run:
git init - VS Code will show the Source Control panel
Step 3: Stage and Commit
- Click the Source Control icon (looks like branching lines)
- Click "+" next to files to stage them
- Add commit message: "Initial commit: AI Mail Agent - Day 1 Complete"
- Click the β checkmark to commit
Step 4: Push to GitHub
- Click "Publish to GitHub" button
- Choose repository name:
ai-mail-agent - Select "Public"
- Click "Publish to GitHub"
π Files to Include in Your Repository
Make sure your project folder contains:
ai-mail-agent/
βββ README.md # The one we created
βββ ai_mail_agent2.ipynb # Your main notebook
βββ requirements.txt # (Create this - see below)
βββ .gitignore # (Create this - see below)
βββ LICENSE # (Optional)
Create requirements.txt
requests==2.31.0
python-frontmatter==1.0.0
jupyter==1.0.0
Create .gitignore
# Jupyter Notebook checkpoints
.ipynb_checkpoints/
# Python cache
__pycache__/
*.pyc
*.pyo
*.pyd
# Environment variables
.env
.venv/
# IDE files
.vscode/
.idea/
# OS generated files
.DS_Store
Thumbs.db
β After Uploading - Verify Success
- Visit your repository: https://github.com/TeslimAdeyanju/ai-mail-agent
- Check that you see:
- Your beautiful README with the 7-day outline
- Your Jupyter notebook