README: add HF-download install path

README.md

@@ -86,9 +86,29 @@ Per-group dequantization rounding compounds across the 36 decoder layers and sho
 
 Requires macOS on Apple Silicon (M1 or newer). Tested on macOS 14+ with a 64 GB Mac Studio.
 
+### Quick start (download pre-converted weights — recommended)
+
 ```bash
-git clone https://github.com/<you>/hidream-o1-mlx
+# Clone the repo (code, docs, samples)
+hf download Mrbizarro/HiDream-O1-Image-Dev-mlx-bf16 --local-dir hidream-o1-mlx
 cd hidream-o1-mlx
+
+# Set up the venv
+uv venv --python 3.11
+uv pip install -r requirements.txt
+
+# Generate (model files are at the repo root — pass --model-path .)
+.venv/bin/python scripts/hidream_o1/generate_hidream_o1_mlx.py \
+  --model-path . \
+  --prompt "your prompt here" \
+  --output out.png
+```
+
+### Or convert from upstream weights yourself
+
+```bash
+git clone https://huggingface.co/Mrbizarro/HiDream-O1-Image-Dev-mlx-bf16
+cd HiDream-O1-Image-Dev-mlx-bf16
 uv venv --python 3.11
 uv pip install -r requirements.txt