Update README.md

README.md

@@ -93,14 +93,17 @@ Follow the official PyTorch installation guide for your platform:
 
 VAAS will automatically detect PyTorch at runtime and raise a clear error if it is missing.
 
-
 ## Usage
 
-### Basic inference
+---
+
+### 1. Basic inference on local and online images
 
 ```python
 from vaas.inference.pipeline import VAASPipeline
 from PIL import Image
+import requests
+from io import BytesIO
 
 pipeline = VAASPipeline.from_pretrained(
     "OBA-Research/vaas-v1-df2023",
@@ -108,11 +111,18 @@ pipeline = VAASPipeline.from_pretrained(
     alpha=0.5
 )
 
-image = Image.open("example.jpg").convert("RGB")
+# # Option A: Using a local image
+# image = Image.open("example.jpg").convert("RGB")
+# result = pipeline(image)
+
+# Option B: Using an online image
+url = "https://raw.githubusercontent.com/OBA-Research/VAAS/main/examples/images/COCO_DF_C110B00000_00539519.jpg"
+image = Image.open(BytesIO(requests.get(url).content)).convert("RGB")
 result = pipeline(image)
 
 print(result)
 anomaly_map = result["anomaly_map"]
+
 ```
 
 #### Output Format
@@ -126,7 +136,7 @@ anomaly_map = result["anomaly_map"]
 }
 ```
 
-### Inference with visual explanation
+### 2. Inference with visual explanation
 
 VAAS can also generate a qualitative visualization combining:
 
@@ -135,8 +145,9 @@ VAAS can also generate a qualitative visualization combining:
 * Final hybrid anomaly score (S_H)
 
 ```python
+
 pipeline.visualize(
-    image="image.jpg",
+    image=image,
     save_path="vaas_visualization.png",
     mode="all",        # options: "all", "px", "binary", "fx"
     threshold=0.5,
@@ -236,6 +247,14 @@ If you use VAAS in your research, please cite both the software and the associat
 
 ---
 
+## Contributing
+
+We welcome contributions that improve the usability, robustness, and extensibility of VAAS.
+
+Please see the full guidelines on [**Github**](https://github.com/OBA-Research/VAAS) in **[CONTRIBUTING.md](https://github.com/OBA-Research/VAAS/blob/main/CONTRIBUTING.md)**.
+
+---
+
 ## License
 
 MIT License
@@ -245,4 +264,5 @@ MIT License
 ## Maintainers
 
 **OBA-Research**
-[https://huggingface.co/OBA-Research](https://huggingface.co/OBA-Research)
+- [https://github.com/OBA-Research](https://github.com/OBA-Research)
+- [https://huggingface.co/OBA-Research](https://huggingface.co/OBA-Research)