Set up Hugging Face
Hugging Face stores modules in repositories, addressed as owner/name.
HistoForge needs permission to read the repositories it downloads and to write to repositories
where you publish modules.
Create an access token
Create a Hugging Face account, or sign in to an existing account.
Open Settings → Access Tokens and create a new token.
Name it
HistoForgeso you can identify its purpose later.Choose the Write role for the full download-and-publish workflow. This role includes read access and permission to create or update repositories your account can write to.
Create the token and copy it for HistoForge setup in QuPath. Treat it as a password.
A Write token can modify any repository your account can write to. For narrower access, or if your organization requires it, use a fine-grained token with read access to source repositories and read/write access to the intended publication destination. Creating a new repository also requires permission in its owner account or organization. See Hugging Face’s token guide.
No Hugging Face inference, billing or organization-administration permissions are needed. HistoForge runs the models in Modal. Gated model repositories still require your account to be granted access; a token does not bypass that approval. An organization may also require administrator approval of the token itself.
Connect it during HistoForge setup
During Install and connect, enter the token in QuPath and select Save token before Set up backend. The installation guide explains how it is stored and checked.
Do not include the token in a project file, screenshot or support message.