

Photo by author
# Introduction
An online portfolio is not optional. It’s usually the first thing people want to see when you want to see what you can actually do. Not your CV. Not your LinkedIn. Your Work If you’re building things as a developer, data scientist, ML engineer, designer, or even learner, a portfolio gives your projects a place to live. And you don’t need paid hosting to do this.
Embracing facial spaces is one of those tools that people tend to overlook. It’s free, easy to deploy, and good enough to host a clean personal site with a live demo. You can keep it simple or add interactive pieces if that suits your work. In this article, we’ll cover what embracing facial spaces is all about, why it’s great for departments, and how you can deploy your own step-by-step.
# What about hugging facial spaces?
Embrace Facespace is a platform that allows you to host web applications directly from a GitHub repository, making deployment easy and accessible even for beginners. Although it was originally designed to showcase machine learning demos, the platform has evolved significantly and now supports a wide range of use cases, including static websites, Python-based applications, interactive user interfaces, and fully functional AI-powered demos. You can create spaces using:
- Static HTML/CSS/JS
- Gradio (Python UI Framework)
- Streamlet
For departments, this flexibility is a huge advantage. Let’s see step by step how to host your portfolio on Embrace for free.
# Step 1: Create a huggable face account
Go to Face Hugging and Sign up.
# Step 2: Preparing Your Portfolio
You can choose one of the following methods:
// Option A: Static Website (HTML/CSS/JS)
Your folder should look like this:
portfolio/
│── index.html
│── style.css
│── script.js// Option B: Python based portfolio (Gradio / Streamlet)
This includes the files:
# Step 3: Create a new location
Click New Location


It opens the following page

Select:
- owner: Your username
- Place Name: For example my portfolio
- License: MIT (recommended)
Select SDK:
- Static for HTML, CSS, and JS portfolios
- Gradio for Python-based interactive portfolios
- Streamlined for data dashboards
After filling, click Make room.


# Step 4: Upload or link your code
You can upload files directly or connect to a GitHub repository.
- For static SDK, just upload the index html and assets.
- To grade or smooth, make sure:
- app.py exists
- Requirements TXT lists the dependencies
Face Hug automatically creates and deploys your location. For example, since I’ve chosen Gradio, I’ll click on the Create app.py file:

After that, the following page opens:

I would edit the app.p file as follows:
import gradio as gr
def contact_message(name, message):
return f"Thanks {name}! Your message has been received 😊"
with gr.Blocks(title="Eisha's Portfolio") as demo:
gr.Markdown(
"""
# 👋 Hi, I'm Kanwal
### AI / ML Enthusiast | Python Developer
Welcome to my portfolio!
I enjoy building AI-powered applications and clean backend systems.
"""
)
gr.Markdown("## 🚀 Projects")
gr.Markdown(
"""
**🔹 PDF Parser with LangChain**
Custom PDF parsing with header/footer removal and LLM integration.
**🔹 Case Similarity Finder (FYP)**
Finds similar medical/legal cases using LLaMA-based embeddings.
**🔹 AI Chatbot Demo**
Conversational AI built using Hugging Face models.
"""
)
gr.Markdown("## Resume")
gr.Markdown(
"(Download my resume)(
)
gr.Markdown("## Contact Me")
name = gr.Textbox(label="Your Name")
message = gr.Textbox(label="Your Message", lines=3)
output = gr.Textbox(label="Response")
submit = gr.Button("Send Message")
submit.click(contact_message, inputs=(name, message), outputs=output)
gr.Markdown(
"""
---
🔗 **GitHub:**
🔗 **LinkedIn:**
"""
)
demo.launch()After editing the app.py file, click Man to Man on the new file:

# Step 5: Your portfolio is live
Now, on the same page, click on the app to view your portfolio.![]()
![]()
On clicking, you can view your portfolio:

Alternatively, you can also visit https://
- About me section
- Projects with live demos
- Restart the download
- Contact link
- GitHub and LinkedIn
With Gradio, you can turn it into an interactive experience.
# Tips to make your portfolio stand out
-
Add a live demo:
- The ML model
- Chatbots
- NLP Tools
- Data Concepts
- Keep it light: Free spaces have resource limits, so optimize assets
- Use a clean UI: Minimal design on glossy animations
- Add a Readme.md: Your space page displays readme content, so use it wisely
# Final thoughts
Embracing Facespaces is more than a demo platform. It is a free, modern and powerful hosting solution for departments. If your work involves code, data, or AI, hosting your portfolio on Spaces instantly differentiates you from traditional static sites. Your portfolio shouldn’t just say what you can do. It should show directly.
Kanwal Mehreen is a machine learning engineer and technical writer with a deep passion for data science and the intersection of AI with medicine. He co-authored the eBook “Maximizing Productivity with ChatGPT.” As a 2022 Google Generation Scholar for APAC, she champions diversity and academic excellence. He has also been recognized as a Teradata Diversity in Tech Scholar, a MITACS GlobalLink Research Scholar, and a Harvard Wicked Scholar. Kanwal is a passionate advocate for change, having founded the Fame Code to empower women in stem fields.


