Upload README.md with huggingface_hub

README.md

@@ -1,3 +1,32 @@
 ---
 license: apache-2.0
 ---
+
+# BRIDGE Model Weights
+
+This repository contains the trained BRIDGE model weights for coarse-mask local image editing.
+
+## Usage
+
+```python
+from safetensors.torch import load_file
+state = load_file("model.safetensors")
+```
+
+- `pipe.ste.*` — GateBlocks (Discrete Geometric Gate) weights
+- `lora_*` — LoRA adapters (rank 512)
+
+**Base model required:** `Qwen/Qwen-Image-Edit-2511`
+
+See https://github.com/XIONGPEILIN/BRIDGE for inference code and usage instructions.
+
+## Citation
+
+```bibtex
+@article{xiong2025bridge,
+  title={BRIDGE: Background Routing and Isolated Discrete Gating for Coarse-Mask Local Editing},
+  author={Peilin Xiong, Honghui Yuan, Junwen Chen, Keiji Yanai},
+  journal={arXiv preprint arXiv:2605.07846},
+  year={2025}
+}
+```