Upload README.md with huggingface_hub

README.md

@@ -31,14 +31,44 @@ config = AutoConfig.from_pretrained('Synthyra/ESMplusplus_small', trust_remote_c
 config.attn_backend = "flex"  # or "kernels_flash", "sdpa", "auto"
 model = AutoModelForMaskedLM.from_pretrained('Synthyra/ESMplusplus_small', config=config, trust_remote_code=True)
 ```
-
-`torch.compile(model)` is heavily recommended for sustained throughput, especially with Flex Attention.
-
-
-## Use with Hugging Face Transformers
-```python
-from transformers import AutoModelForMaskedLM
-model = AutoModelForMaskedLM.from_pretrained('Synthyra/ESMplusplus_small', trust_remote_code=True)
+
+`torch.compile(model)` is heavily recommended for sustained throughput, especially with Flex Attention.
+
+## Binder Design Regularizer
+
+The FastPLMs binder design tutorial uses the ESM++ model family as the
+masked-LM pseudoperplexity regularizer while FastPLMs ESMFold2 experimental
+models provide differentiable folding losses and final critics. The verified
+EGFR example defaults to `Synthyra/ESMplusplus_6B`; this 300M checkpoint exposes
+the same `AutoModelForMaskedLM` API and can be used as a lower-memory
+regularizer by editing `FastPLMsBinderDesign.lm_name` in
+`cookbook/tutorials/binder_design_fastplms.py`.
+
+Default verified run:
+
+```bash
+python cookbook/tutorials/binder_design_fastplms.py \
+  --backend local \
+  --target-name egfr \
+  --binder-sequence '################################################################################################################################' \
+  --not-antibody \
+  --steps 150 \
+  --batch-size 1 \
+  --seed 103 \
+  --output-dir binder_design_egfr_len128_seed103
+```
+
+The verified 6B-regularized result had hero mean iPTM `0.913870`, hero min iPTM
+`0.904600`, and all four ESMFold2 hero critics above `0.9`.
+
+See [`docs/binder_design.md`](https://github.com/Synthyra/FastPLMs/blob/main/docs/binder_design.md)
+for the complete workflow, output files, metrics, and Modal/local compute
+options.
+
+## Use with Hugging Face Transformers
+```python
+from transformers import AutoModelForMaskedLM
+model = AutoModelForMaskedLM.from_pretrained('Synthyra/ESMplusplus_small', trust_remote_code=True)
 tokenizer = model.tokenizer
 
 sequences = ['MPRTEIN', 'MSEQWENCE']