# `mix fastembed.download`
[🔗](https://github.com/elchemista/ex_fastembed/blob/v0.1.2/lib/mix/tasks/fastembed.download.ex#L1)

Downloads a model into `FASTEMBED_CACHE_DIR` (default `.fastembed_cache`).
An `HF_HOME` exported before starting the VM takes precedence.

    mix fastembed.download BGESmallENV15
    mix fastembed.download AllMiniLML6V2Q
    mix fastembed.download JINARerankerV1TurboEn --reranker

Accepts the same aliases as `ExFastembed.load/1` and `ExFastembed.load_reranker/1`.
Use `mix fastembed.models` to list variants and their cache status.

Complete cached models are skipped. Missing files are downloaded without
initializing an ONNX session or changing loaded models. Existing non-empty files
are reused. Empty snapshot files and dangling snapshot links are replaced;
their link targets are kept. A directory occupying a required file path returns
an error. A download failure exits with a Mix error.
Call `ExFastembed.load/1` or `ExFastembed.load_reranker/1` before inference to
initialize the model and validate its contents.

---

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