Document original upstream model download links

README.md

@@ -62,6 +62,53 @@ runtime README and `configs/assets.example.json`; this release contains
 only the two trained model components. `SHA256SUMS` and `inventory.json`
 provide integrity information for the released files.
 
+## Upstream runtime dependencies
+
+The trained-weight release does not include unchanged upstream models.
+Download these components from their original sources:
+
+| Runtime asset | Original download source |
+| --- | --- |
+| Qwen3-VL conditioning weights/config (`qwen_model`) | [MiniMax-H3 / Ref2VA/text_encoder](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/main/Ref2VA/text_encoder) — the H3-compatible conditioning checkpoint |
+| Tokenizer (`tokenizer`) | [MiniMax-H3 / Ref2VA/tokenizer](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/main/Ref2VA/tokenizer) |
+| Image/text processor (`qwen_processor`) | [MiniMax-H3 / Ref2VA/processor](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/main/Ref2VA/processor) |
+| Native H3 video VAE (`native_vae`) | [MiniMax-H3 / Ref2VA/video_vae/source](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/main/Ref2VA/video_vae/source) — `model.safetensors`, used for decoder construction |
+| Native H3 audio VAE (`audio_vae`) | [MiniMax-H3 / Ref2VA/audio_vae](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/main/Ref2VA/audio_vae) — `model.safetensors` |
+| Official H3 TAE (`tae`) | [TAeHV / taeh3.pth](https://github.com/madebyollin/taehv/blob/62f7591f59dfbb4c3c02b7a621d180a9eeaba26c/taeh3.pth) — official GitHub release; no official HF model repository was verified |
+
+The [Qwen3-VL upstream model](https://huggingface.co/Qwen/Qwen3-VL-32B-Instruct)
+is the upstream architecture. For this runtime, use the H3-distributed
+`Ref2VA/text_encoder` checkpoint above rather than assuming another Qwen
+checkpoint is interchangeable.
+
+`qwen_dcp` is a PyTorch distributed-checkpoint representation of those
+conditioning weights, not a separate model. The current runtime loader
+requires a compatible local DCP conversion; the public upstream HF download
+provides safetensors, not the local DCP directory. Do not point
+`qwen_dcp` at the safetensors directory.
+
+Download the H3 dependencies without its original transformer weights:
+
+```python
+from huggingface_hub import snapshot_download
+snapshot_download(
+    "MiniMaxAI/MiniMax-H3", local_dir="./MiniMax-H3",
+    allow_patterns=["Ref2VA/text_encoder/*", "Ref2VA/tokenizer/*",
+                    "Ref2VA/processor/*", "Ref2VA/video_vae/*",
+                    "Ref2VA/audio_vae/*"],
+)
+```
+
+Download the verified official TAE weights:
+
+```bash
+curl -fL -o taeh3_official.pth \
+  https://raw.githubusercontent.com/madebyollin/taehv/62f7591f59dfbb4c3c02b7a621d180a9eeaba26c/taeh3.pth
+```
+
+Fill the corresponding paths in the runtime asset manifest. These links
+identify external dependencies; they do not add their weights to this release.
+
 ## License
 
 These model weights are derivatives governed by the MiniMax H3 Community

SHA256SUMS

@@ -1,6 +1,6 @@
 59b99642b95ea21630e311198ddbfffbfe05aadba0c2f5d884cbdf4efcc90f44  LICENSE
 48edcb6a7daab4034f94b829a2a135c0ac9c477eb6db756161af5f19a4ac118c  NOTICE
-432a2b2f6886a76f61c16afcad59a4517df2c9cac9f4afb7a7dc6e1b6cd4b6ea  README.md
+03a43066bd6f07d55e90e53cb44d2e17909f374e1b64d82626c1f4b411c6ba1d  README.md
 46c17356261c81b43309da11824cc62072df0f4fa9c102a0b5ecdeb42085d8f2  backbone/model-00001-of-00009.safetensors
 7d943cc7fbb9d3d3d16f5bd1c09d56f17c720f5b90ff7f261f576d164ce8e5a2  backbone/model-00002-of-00009.safetensors
 19d7d8a5e7a1c9f15d03b698e7bbc2246aeca7441f4b00e96ef21f1d3d174834  backbone/model-00003-of-00009.safetensors