FL HF Uploader Absolute

This is the plain, no-frills member of Fill-Nodes' three Hugging Face uploaders. FL_HFHubModelUploader builds you a full model repo with a generated README; FL_HF_Character enforces a studio/project/character folder structure. FL_HF_UploaderAbsolute skips all of that ceremony - you give it a file and an exact upload path inside the repo, and it puts the file there. Good for when you just need something on the Hub and don't need a model card written for you.

How it works

You point it at an owner/repo_name, give it an upload_path (the exact folder path inside the repo the file should land at), pick a repo_type, and wire in whichever file type you're actually uploading - a LoRA, a zipped dataset, a caption layout image, a caption PDF, or a CSV. It uploads to that path with progress tracking, creating the repo first if you tell it to.

The inputs and outputs that matter

Required: owner, repo_name, upload_path (e.g. folder1/folder2/folder3 - this is where inside the repo the file goes), create_new_repo (True/False), and repo_type (model / dataset / space).

Optional, wire in one or more: lora_file (a path string), dataset_zip (ZIP), caption_layout (IMAGE), caption_PDF_layout (PDF), csv_file (CSV).

Notice what's not in the required inputs: no api_key field. Per the README, this node authenticates via the HUGGINGFACE_API_KEY environment variable instead of a widget you type a token into - the other two HF uploader nodes in this pack take the key as a direct input.

Output: a STRING result/status.

How to install it

Part of ComfyUI_Fill-Nodes. ComfyUI Manager: search ComfyUI_Fill-Nodes, install, restart. Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/filliptm/ComfyUI_Fill-Nodes
pip install -r ComfyUI_Fill-Nodes/requirements.txt

then restart, and set HUGGINGFACE_API_KEY in the environment ComfyUI runs in before you use this node.

Common issues & troubleshooting

"It's not authenticating" is usually a missing environment variable, not a broken node. Since there's no on-node token field, if HUGGINGFACE_API_KEY isn't set in the shell/service that launched ComfyUI, uploads will fail with an auth error that has nothing to do with your inputs being wrong. Set it in your environment (or your ComfyUI launch script / .env, depending on how you run it) and restart ComfyUI so the process actually picks it up.

The key needs write access. A read-only HF token will authenticate fine and then fail on the actual upload - generate a write-scoped token from your Hugging Face account settings if uploads are rejected specifically at the write step.

upload_path is relative to the repo root, not your local filesystem. It's easy to read folder1/folder2/folder3 and think local paths - it's actually the destination structure inside the Hub repo. Files land nested under that path in the repo, however deep you make it.

Repo creation is a one-time flag. create_new_repo set True on a repo that already exists is the more common mistake than the reverse - check the repo doesn't already exist before flipping it on, or just leave it False once you know the repo's there.