docs: align model card with PhaseFlow_training_data style

Add banner figure, related-resource cross-links, and file inventory metadata.

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+figures/*.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,34 +1,75 @@
 ---
+pretty_name: PhaseFlow
 license: apache-2.0
 library_name: pytorch
 tags:
   - protein
   - peptide
-  - llps
-  - dpr
+  - liquid-liquid-phase-separation
+  - disordered-protein-regions
+  - pytorch
 ---
 
-# PhaseFlow checkpoint
+# PhaseFlow
 
-This repository provides the PhaseFlow runtime checkpoint used for peptide
+![PhaseFlow: sequence data to phase-behaviour learning](figures/PhaseFlow.png)
+
+This repository hosts the unified PhaseFlow runtime checkpoint used for peptide
 phase prediction, full-length protein LLPS prediction, and droplet-promoting
 region (DPR) localization.
 
-## Files
-
-| File | Description | SHA256 |
+| Component | Task | Embedded weights |
 | --- | --- | --- |
-| `PhaseFlow.pt` | Combined PhaseFlow runtime checkpoint (peptide, full-protein, and DPR weights) | `7fb0091e6dd5a85bd3a6be7a0b606501700c4b8f28ff9b6e309267835a2fdff0` |
+| Peptide PhaseFlow | Short-peptide 4×4 PSSI phase-diagram prediction and phase-conditioned sequence generation | Peptide tokenizer, shared Transformer, and Flow Matching stack |
+| CondenGT / LLPS | Protein-level liquid-liquid phase-separation prediction | Full-protein sequence-context encoder and LLPS readout |
+| DPR stack | Driving phase-separation region localization | Region-scoring head and post-processing state for DPR scanning |
 
-Download it with:
+Download the checkpoint with:
 
 ```bash
 hf download yanjiehuang/PhaseFlow PhaseFlow.pt --local-dir artifacts/models
 ```
 
-The checkpoint is loaded by the public PhaseFlow codebase. It contains the
-embedded peptide PhaseFlow state, the full-protein CondenGT state, and the DPR
-stack state; it is not a peptide-only checkpoint.
+## Related resources
+
+| Resource | Link | Role |
+| --- | --- | --- |
+| PhaseFlow code | [github.com/kevinhyj/PhaseFlow](https://github.com/kevinhyj/PhaseFlow) | Installation, inference scripts, configs, and documentation |
+| PhaseFlow training data | [yanjiehuang/PhaseFlow_training_data](https://huggingface.co/datasets/yanjiehuang/PhaseFlow_training_data) | Public peptide, LLPS, and DPR research-data packages |
+| PhaseFlow web app | [phaseflow.bio](http://phaseflow.bio/) | Online model usage (coming soon; site currently under review) |
+
+## Open access
+
+The checkpoint and accompanying model card in this repository are fully open
+source and freely available to the community. We warmly welcome their use in
+research, benchmarking, method development, and reproducible studies. Please cite
+the relevant PhaseFlow work and retain appropriate source attribution when
+using or redistributing the weights.
+
+## Integrity
+
+This repository contains `metadata/file_inventory.csv`. Verify all listed files
+before use; the inventory intentionally excludes itself to avoid a
+self-referential checksum.
+
+```python
+import csv
+import hashlib
+from pathlib import Path
+
+repo = Path(".")
+with (repo / "metadata/file_inventory.csv").open(newline="") as handle:
+    for item in csv.DictReader(handle):
+        digest = hashlib.sha256((repo / item["path"]).read_bytes()).hexdigest()
+        assert digest == item["sha256"], item["path"]
+```
+
+| File | Description | SHA256 |
+| --- | --- | --- |
+| `PhaseFlow.pt` | Combined PhaseFlow runtime checkpoint (peptide, full-protein, and DPR weights) | `7fb0091e6dd5a85bd3a6be7a0b606501700c4b8f28ff9b6e309267835a2fdff0` |
+
+## Responsible use
 
-See the [PhaseFlow GitHub repository](https://github.com/kevinhyj/PhaseFlow)
-for installation and inference workflows.
+These weights are research resources, not clinical or diagnostic tools. Model
+predictions require independent validation and must be interpreted under the
+documented evidence and coordinate conventions in the PhaseFlow codebase.

metadata/file_inventory.csv

@@ -0,0 +1,2 @@
+path,size_bytes,sha256
+PhaseFlow.pt,340953234,7fb0091e6dd5a85bd3a6be7a0b606501700c4b8f28ff9b6e309267835a2fdff0