# `mix obscura.profile.prepare`
[🔗](https://github.com/hfiguera/obscura/blob/v0.2.0/lib/mix/tasks/obscura.profile.prepare.ex#L1)

Explicitly prepares and validates a reusable Obscura profile runtime.

    mix obscura.profile.prepare --profile balanced --backend emily --allow-download
    mix obscura.profile.prepare --profile balanced --backend emily --offline --json

Downloads require `--allow-download`; otherwise preparation is cache-only.
`--offline` always forbids remote asset access. The task reports the effective
cache directory, model index, observed download bytes, stage transitions,
elapsed time, and final readiness. JSON mode emits one object per line and
disables Bumblebee's terminal progress bar.

Before preparing an asset with a known commercial-use requirement, the task
emits an `asset_license_notice`. `--allow-download` permits network access;
it does not accept model terms or establish deployment authorization.

Online preparation retries one transient model or tokenizer load failure.
Recovery quarantines unreferenced partial cache files before downloading a
clean replacement. Quarantined files remain on disk for operator review.

---

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