kvokka/Deploy to Hugging Face (Spaces/Models/Datasets)

Sync a local folder to a Hugging Face repo (space/model/dataset) with an optional public proxy Space for private Space APIs.

Trust Signals

name	description	required	default
huggingface_repo	Hugging Face repo id to sync to. Accepts 'owner/name' or just 'name' (will use token owner).	no	same_with_github_repo
hf_token	Hugging Face token with write access.	yes	—
repo_type	Repo type: space, model, or dataset.	no	space
space_sdk	If repo_type=space and repo doesn't exist yet, space SDK to create with: gradio\|streamlit\|static\|docker.	no	gradio
private	If true, create repo as private (only applies on creation).	no	false
source_dir	Local directory to upload to Hugging Face.	no	.
commit_message	Commit message for the sync commit.	no	sync: deploy from GitHub Actions
create_proxy	If true, create/update a public proxy Space that forwards to the (private) target Space API.	no	false
proxy_space_suffix	Suffix appended to the target space name to form the proxy space name.	no	-proxy
proxy_hf_token	Optional token used by the proxy space to call upstream. If empty, falls back to hf_token.	no	""
proxy_target_url	Optional upstream URL override for the proxy. If empty, computed from target space repo id.	no	""
proxy_allow_origins	CORS allow-origins for the proxy. Use '*' or a comma-separated list of origins.	no	*
space_secrets	Optional YAML mapping of Hugging Face Space secret key/value strings to create/update on the target Space.	no	""
space_variables	Optional YAML mapping of Hugging Face Space variable key/value strings to create/update on the target Space.	no	""

name	description
repo_id	Resolved Hugging Face repo id (owner/name).
repo_url	Hugging Face UI URL for the repo.
space_url	Hugging Face UI URL for the Space (empty for non-space).
proxy_enabled	true/false depending on whether proxy was created.
proxy_repo_id	Proxy Space repo id (empty if disabled).
proxy_url	Proxy Space URL (empty if disabled).