README.md

metadata

title: Muhammad Saad — Portfolio
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: gradio
app_file: app.py
pinned: false
license: mit

Muhammad Saad — Portfolio

CS student @ North South University • Tech enthusiast • I break things (on purpose) and fix them better.

This is my live portfolio hosted on Hugging Face Spaces using Gradio.
It shows my projects, skills, and a simple contact section.

Live URL (after you make the Space public):
https://saad003-portf01.hf.space

---

✨ Features

• Tabs for About, Projects, Skills, Contact
• “Funny-but-true” skills section (because debugging at 2 AM is a skill)
• Contact tab formats a message and provides a mailto button
• Easy to extend with more projects or embedded demos

---

🚀 Quick Start (on Hugging Face Spaces)

1. Put these files at repo root:
   • app.py
   • requirements.txt (contains gradio)
   • README.md (this file)
2. Commit & push:

   git add app.py requirements.txt README.md
   git commit -m "Initial portfolio"
   git push
   

3. In the Space Settings, set Visibility → Public.
4. Share the link: https://saad003-portf01.hf.space

---

🧪 Run Locally

pip install -r requirements.txt
python app.py

Then open the local URL printed in your terminal.

---

🧱 Repo Structure

portf01/
├─ app.py
├─ requirements.txt
└─ README.md   <-- you are here

---

🛠️ Customize

• In app.py, update:
  • NAME, TAGLINE, and the About text
  • Social links in SOCIALS_MD
  • Your email in mailto_link() (replace you@example.com)
  • Project list in PROJECTS_MD
• Add screenshots or thumbnails if you want (e.g., put images in /assets and reference them in Markdown).

---

🔗 Useful Links

• My Hugging Face profile: (add link)
• GitHub: (add link)
• LinkedIn: (add link)

---

📸 Screenshot (optional)

Add a preview image to your repo (e.g., assets/screenshot.png) and embed:

![Portfolio preview](assets/screenshot.png)

---

📄 License

MIT — feel free to reuse and remix. Credit appreciated. 😊