# `mix hf.upload`
[🔗](https://github.com/huggingface/huggingface_client/blob/v0.1.0/lib/mix/tasks/hf.upload.ex#L1)

Uploads a file or folder to a HuggingFace Hub repository.

    $ mix hf.upload my-org/my-model ./model.safetensors
    $ mix hf.upload my-org/my-model ./outputs/ --path-in-repo models/v2/
    $ mix hf.upload --type dataset my-org/my-dataset ./data/

## Options

  * `--type` / `-t` — repo type: `model`, `dataset`, `space` (default: `model`)
  * `--path-in-repo` — destination path in the repo (default: same as local name)
  * `--commit-message` / `-m` — commit message
  * `--revision` / `-r` — branch to push to (default: `main`)
  * `--token` — HF API token

---

*Consult [api-reference.md](api-reference.md) for complete listing*