docs: update repo structure, fix Quick Start, add tar.gz to Data section

README.md

@@ -89,14 +89,14 @@ This HuggingFace repo stores **checkpoints** and **processed datasets** for repr
 
 ### Data
 
-| Directory | Size | Contents |
-|-----------|------|----------|
-| `data/patches/5cat/` | ~82 MB | 5-category NPZ patch files (train/test splits) |
-| `data/patches/lvis_wide/` | ~1 GB | LVIS-Wide NPZ patches (188K train / 45K test / 12K unseen) |
+| File / Directory | Size | Contents |
+|------------------|------|----------|
+| `data/meshlex_data.tar.gz` | ~1.2 GB | All processed data in one archive (recommended) |
+| `data/patches/` | ~1.1 GB | NPZ patch files (5cat + LVIS-Wide splits) |
 | `data/meshes/` | ~931 MB | Preprocessed decimated OBJ files (5,497 meshes) |
-| `data/objaverse/` | ~2 MB | Download manifests (can recreate download pipeline) |
+| `data/objaverse/` | ~2 MB | Download manifests |
 
-The processed data can be downloaded directly — no need to re-download from Objaverse and re-run preprocessing.
+The `tar.gz` archive contains patches, meshes, and manifests — download it and extract to skip all preprocessing.
 
 ## Core Hypothesis
 
@@ -150,7 +150,7 @@ Training data sourced from [Objaverse-LVIS](https://huggingface.co/datasets/alle
 ```bash
 # Clone the code repo
 git clone https://github.com/Pthahnix/MeshLex-Research.git
-cd Meshlex-Research
+cd MeshLex-Research
 
 # Install dependencies
 pip install -r requirements.txt
@@ -161,12 +161,17 @@ pip install pyg_lib torch_scatter torch_sparse torch_cluster torch_spline_conv \
 # Download processed data from this HF repo
 pip install huggingface_hub
 python -c "
+from huggingface_hub import hf_hub_download
+hf_hub_download('Pthahnix/MeshLex-Research', 'data/meshlex_data.tar.gz', repo_type='model', local_dir='.')
+"
+tar xzf data/meshlex_data.tar.gz -C data/
+
+# Download checkpoints
+python -c "
 from huggingface_hub import snapshot_download
-snapshot_download('Pthahnix/MeshLex-Research', local_dir='hf_download', repo_type='model')
+snapshot_download('Pthahnix/MeshLex-Research', allow_patterns='checkpoints/*', repo_type='model', local_dir='.')
 "
-# Move data and checkpoints into place
-cp -r hf_download/data/ data/
-cp -r hf_download/checkpoints/ data/checkpoints/
+mv checkpoints data/checkpoints
 
 # Run evaluation on Exp4 (best model)
 PYTHONPATH=. python scripts/evaluate.py \