Docs
Reference

Hugging Face Spaces

Push a penv environment into a Hugging Face Space's secrets.

Push a penv environment into a Hugging Face Space's secrets.

The connection

WhatThis provider
VendorHugging Face
Keyhuggingface-space-secret
Availabilityavailable. You can connect it today.
Credential penv holdshuggingface-token
Values read backno
Activationrestart-on-write

What it moves

DirectionWhat it does
exportWrites names and values from penv into the store.

Hugging Face returns no value once it holds one, so penv can write here and cannot read back.

When a written value goes live

restart-on-write. Writing a value restarts the workload.

What happens to a name that exists

DirectionPolicies you can pick
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

How you connect

You paste a credential you already hold. penv seals it and never shows it again.

FieldLabelKindRequiredWhat it is
tokenAccess tokensecret, masked here and sealedyesA user access token with write access to this Space.

What a mapping asks for

Answered once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
repoIdSpacetextyesnoOwner and Space name, as they appear in its URL.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
spaces:readevery directionyesPreview cannot list the Space's secrets.
spaces:writeexportyesExport cannot write anything.