huggingface-spaces-deployer

Automate GitHub repository deployment to Hugging Face Spaces with GitHub Actions workflows.

Updated Nov 28, 2025
One-click install
npx skills add https://github.com/syeda-hoorain-ali/physical-ai --skill huggingface-spaces-deployer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: huggingface-spaces-deployer
Source: https://github.com/syeda-hoorain-ali/physical-ai/tree/main/.claude/skills/huggingface-spaces-deployer
Command: npx skills add https://github.com/syeda-hoorain-ali/physical-ai --skill huggingface-spaces-deployer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill helps users deploy their GitHub repositories to Hugging Face Spaces by providing the necessary workflow files, token setup instructions, and deployment procedures.

Core Features & Use Cases

  • Generate and manage GitHub Actions workflows to sync code to Hugging Face Spaces
  • Guide users through creating a Hugging Face token and configuring repository secrets
  • Offer both automated deployment via Actions and manual deployment options

Quick Start

Create a Hugging Face token, configure HF_TOKEN as a GitHub secret, then push to main to start automated deployment.

Frequently Asked Questions about huggingface-spaces-deployer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a GitHub repository to Hugging Face Spaces using GitHub Actions?

To deploy a GitHub repository to Hugging Face Spaces, you need to configure an HF_TOKEN as a GitHub secret and set up a GitHub Actions workflow that syncs your code on push to main, automating the deployment process.

What do I need to set up before automating Hugging Face Spaces deployment?

Before automating Hugging Face Spaces deployment, you need a GitHub repository containing a root Dockerfile or compatible entry point, and a configured Hugging Face token stored as a GitHub repository secret for authentication.

Can I manually deploy code to Hugging Face Spaces without using GitHub Actions?

Yes, manual deployment to Hugging Face Spaces is supported. You can bypass the automated GitHub Actions workflows and manually push your repository code directly to Hugging Face using the configured token and provided deployment guidance.

Does deploying to Hugging Face Spaces require a specific repository structure?

Deploying to Hugging Face Spaces requires a typical repository layout that includes a root Dockerfile or a compatible entry point. The environment must be correctly set up with the HF_TOKEN to ensure the workflow functions properly.

What is the best way to sync code from GitHub to Hugging Face Spaces automatically?

The best way to automatically sync code from GitHub to Hugging Face Spaces is by generating a GitHub Actions workflow that triggers on pushes to the main branch, utilizing a stored Hugging Face token for secure authentication.