Buildathons.ai

Deploy your first HuggingFace Space Course

Go from zero to a live ML demo app in 15 minutes using Gradio and any HuggingFace model. Follow this beginner course with 5 practical lessons.

Course overview

Go from zero to a live ML demo app in 15 minutes using Gradio and any HuggingFace model.

Create a HuggingFace account

Head to huggingface.co and sign up for a free account. Then go to Settings → Access Tokens and create a 'write' token — you'll need this to push your Space. Your token starts with 'hf'. Keep it secret — add it as a repo secret, never commit it.

Create a new Space

On the HuggingFace website, click your avatar → New Space. Choose a name, set it to Public, and select Gradio as the SDK. This creates a git repo backed by HuggingFace infrastructure.

Build your app.py

Clone the Space repo and create your Gradio app.

Add requirements.txt

Create a requirements.txt so HuggingFace knows what to install.

Push and deploy

Commit and push your files. HuggingFace automatically builds and deploys your Space — usually takes 2-3 minutes. If your Space shows an error, check the Logs tab on the Space page for Python errors.