Upload 3 files

README.md

@@ -1,14 +1,94 @@
+
 ---
-title: Portf01
-emoji: 🦀
-colorFrom: gray
-colorTo: gray
+title: "Muhammad Saad — Portfolio"
+emoji: "🚀"
+colorFrom: "blue"
+colorTo: "purple"
 sdk: gradio
-sdk_version: 5.49.1
 app_file: app.py
 pinned: false
-license: apache-2.0
-short_description: testing a portfolio
+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:
+   ```bash
+   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
+```bash
+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:
+```markdown
+![Portfolio preview](assets/screenshot.png)
+```
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## 📄 License
+MIT — feel free to reuse and remix. Credit appreciated. 😊

app.py

@@ -0,0 +1,96 @@
+
+import gradio as gr
+from datetime import datetime
+
+NAME = "Muhammad Saad"
+TAGLINE = "CS @ North South University • Tech enthusiast • Builder of fun things"
+
+ABOUT_MD = f"""
+# 👋 Hey, I'm {NAME}
+I'm a **Computer Science student at North South University** who loves shipping scrappy ideas,
+breaking stuff (on purpose), and then fixing it better.
+
+**What I'm into:** computer vision, MLOps, model deployment, and turning notebooks into real apps.
+"""
+
+# ← add your real links here
+SOCIALS_MD = """
+**Find me:**  
+- 🌐 Website: <https://example.com>  
+- 🐙 GitHub: <https://github.com/yourhandle>  
+- 🧠 Hugging Face: <https://huggingface.co/yourhandle>  
+- 💼 LinkedIn: <https://linkedin.com/in/yourhandle>  
+"""
+
+PROJECTS_MD = """
+### Selected Projects
+- **Image Similarity App** — FAISS + ResNet embeddings to retrieve near-duplicate medical images.  
+- **Radiology Captioning Playground** — demo of ViT+GPT2 captioner with retrieval-augmented context.  
+- **Tiny MLOps** — Dockerized inference + Space deploy in under 5 minutes.
+"""
+
+# funny-but-true skills
+SKILLS_MD = """
+### Skills (serious-ish)
+- **Python**, **PyTorch**, **Gradio**, **Hugging Face**, **FAISS**, **Docker**
+- **Data wrangling**, **Training pipelines**, **Model serving**, **Prompt tinkering**
+
+### Skills (funny but accurate)
+- **Googling like a Pro**: 10/10 🔍  
+- **Debugging at 2 AM**: 11/10 🧯  
+- **“It worked yesterday” Whisperer**: 9/10 🧙  
+- **Version Control Therapist (merge conflicts)**: 8/10 🪄  
+- **Coffee-driven latency reduction**: -20ms ☕
+"""
+
+CONTACT_HELP = """
+I can't send email for you, but this will format a message you can copy-paste.  
+Or use the **mailto** button to open your email client.
+"""
+
+def format_contact(name, email, message):
+    ts = datetime.now().strftime("%Y-%m-%d %H:%M")
+    return f"""### Thanks, {name or "friend"}!
+**Time:** {ts}  
+**From:** {name} ({email})
+**Message:**
+> {message}
+"""
+
+def mailto_link(name, email, message):
+    import urllib.parse as up
+    to = "you@example.com"  # ← replace with your address
+    subject = up.quote(f"Portfolio message from {name or 'Visitor'}")
+    body = up.quote(f"From: {name} <{email}>\n\n{message}")
+    return f"mailto:{to}?subject={subject}&body={body}"
+
+with gr.Blocks(title=f"{NAME} — Portfolio") as demo:
+    gr.Markdown(f"# {NAME}\n**{TAGLINE}**")
+
+    with gr.Tab("About"):
+        gr.Markdown(ABOUT_MD)
+        gr.Markdown(SOCIALS_MD)
+
+    with gr.Tab("Projects"):
+        gr.Markdown(PROJECTS_MD)
+        gr.Markdown("*(Want live demos here? Link your Spaces or add iframes.)*")
+
+    with gr.Tab("Skills"):
+        gr.Markdown(SKILLS_MD)
+
+    with gr.Tab("Contact"):
+        gr.Markdown(CONTACT_HELP)
+        with gr.Row():
+            name = gr.Textbox(label="Your name", placeholder="Ada Lovelace")
+            email = gr.Textbox(label="Your email", placeholder="ada@example.com")
+        message = gr.Textbox(label="Message", lines=6, placeholder="Write me something nice…")
+        with gr.Row():
+            out = gr.Markdown()
+        with gr.Row():
+            btn_send = gr.Button("Preview message")
+            btn_mail = gr.Button("Open email client (mailto)")
+        btn_send.click(format_contact, [name, email, message], out)
+        btn_mail.click(mailto_link, [name, email, message], out)
+
+if __name__ == "__main__":
+    demo.launch()

requirements.txt

@@ -0,0 +1 @@
+gradio