Fix direct predict usage: output_directory is positional

README.md

@@ -0,0 +1,75 @@
+---
+license: apache-2.0
+library_name: direct
+tags:
+  - mri
+  - reconstruction
+  - modulated-convolution
+  - fastmri
+  - conditional
+---
+
+# DIRECT — Modulated Convolution for Conditional MRI Reconstruction
+
+Pretrained checkpoints and matching YAML configs for
+[Conditional Learned Reconstruction for Medical Imaging](https://proceedings.mlr.press/v315/moriakov26a.html)
+(Moriakov et al., MIDL 2026).
+
+## Dataset
+
+| Anatomy | Dataset | Notes |
+|---|---|---|
+| **Knee** | [fastMRI](https://fastmri.med.nyu.edu/) knee | Multi-coil; conditioned on acceleration \(R\) and ACS fraction |
+| **Prostate** | [fastMRI](https://fastmri.med.nyu.edu/) prostate | Same conditioning |
+
+## Paper
+
+- **MIDL 2026 (PMLR 315:754–780):** [proceedings](https://proceedings.mlr.press/v315/moriakov26a.html) · [OpenReview PDF](https://openreview.net/pdf?id=qNjleGZJis)
+
+## Files
+
+```text
+knee/<name>.yaml
+knee/<name>.pt
+prostate/<name>.yaml
+prostate/<name>.pt
+```
+
+### Knee
+
+| Name | Description |
+|---|---|
+| `vsharp_triang` | Non-modulated vSHARP baseline (triangular \(R\) sampling) |
+| `vsharp_modconv_features_triang` | ModConv features, triangular |
+| `vsharp_modconv_features_triang_32_16` | ModConv features, MLP 32→16 |
+| `vsharp_modconv_features_triang_32_8` | ModConv features, MLP 32→8 |
+| `vsharp_modconv_features_triang_32_16_mod_inp` | ModConv at input |
+| `vsharp_adain_triang_32_16` | AdaIN conditioning baseline |
+
+### Prostate
+
+| Name | Description |
+|---|---|
+| `vsharp_triang` | Non-modulated baseline |
+| `vsharp_modconv_features_triang` | ModConv features |
+| `vsharp_modconv_features_triang_32_16` | ModConv features, MLP 32→16 |
+| `vsharp_modconv_features_triang_32_8` | ModConv features, MLP 32→8 |
+
+## Usage
+
+```bash
+hf download NKI-AI/direct-modulated-convolution --local-dir ./modconv
+
+direct predict ./predictions \
+  --cfg ./modconv/knee/vsharp_modconv_features_triang_32_8.yaml \
+  --checkpoint ./modconv/knee/vsharp_modconv_features_triang_32_8.pt \
+  --data-root /path/to/fastmri/knee/val \
+  --num-gpus 1
+```
+
+The first argument is the **output directory** (predictions), not an experiment folder.
+
+
+## Framework
+
+[DIRECT](https://github.com/NKI-AI/direct) · project docs in `projects/modulated_convolution/` · [NKI-AI](https://huggingface.co/NKI-AI)