Le depot porte tout le moteur, range comme le disque le lit

README.md

@@ -30,12 +30,27 @@ upstream repositories and is listed below.
 
 ## What is in this repository
 
+This repository holds **the whole LocalMesh engine**, except one set Meta
+gates. It is laid out exactly like the folder the engine reads, so one command
+places all of it:
+
+| Folder | Size | What it is | Whose |
+|---|---|---|---|
+| `TRELLIS.2-4B/` | 8.1 GB | the single photo path, in fp8 | [visualbruno](https://huggingface.co/visualbruno/TRELLIS.2-4B-FP8), MIT — rehosted unchanged |
+| `microsoft/` | 148 MB | the sparse structure decoder | [Microsoft](https://huggingface.co/microsoft/TRELLIS-image-large), MIT — rehosted unchanged |
+| `multivue/` | 4.8 GB | the four view path | ours, from Pixal3D — see below |
+
+Rehosted so that one `hf download` replaces six. Taking those two from their
+own repositories works exactly as well; nothing here is modified.
+
+### What is ours, under `multivue/`
+
 | File | Size | Source |
 |---|---|---|
-| `structure_mv_fp8.safetensors` + `.json` | 1.39 GB | fp8 conversion of `ckpts/ss_flow_img_dit_1_3B_64_bf16_mv.safetensors`, TencentARC/Pixal3D |
-| `forme_512_mv_fp8.safetensors` + `.json` | 1.44 GB | fp8 conversion of `ckpts/slat_flow_img2shape_dit_1_3B_512_bf16_mv.safetensors`, TencentARC/Pixal3D |
-| `forme_1024_mv_fp8.safetensors` + `.json` | 1.44 GB | fp8 conversion of `ckpts/slat_flow_img2shape_dit_1_3B_1024_bf16_mv.safetensors`, TencentARC/Pixal3D |
-| `champ.safetensors` | 2.7 MB | valeoai/NAF, official checkpoint, tensors unchanged |
+| `multivue/structure_mv_fp8.safetensors` + `.json` | 1.39 GB | fp8 conversion of `ckpts/ss_flow_img_dit_1_3B_64_bf16_mv.safetensors`, TencentARC/Pixal3D |
+| `multivue/forme_512_mv_fp8.safetensors` + `.json` | 1.44 GB | fp8 conversion of `ckpts/slat_flow_img2shape_dit_1_3B_512_bf16_mv.safetensors`, TencentARC/Pixal3D |
+| `multivue/forme_1024_mv_fp8.safetensors` + `.json` | 1.44 GB | fp8 conversion of `ckpts/slat_flow_img2shape_dit_1_3B_1024_bf16_mv.safetensors`, TencentARC/Pixal3D |
+| `multivue/champ.safetensors` | 2.7 MB | valeoai/NAF, official checkpoint, tensors unchanged |
 
 **`structure_mv_fp8`** fuses the four encoded views into a sparse volume of
 cells. Each view is projected onto the shared grid by its own camera.
@@ -48,8 +63,9 @@ decoder turns its latent into the mesh.
 fills in the detail the token map loses: the token map is sixteen times coarser
 than the photo.
 
-4.28 GB in total, seven files. Keep the three `.json` descriptors next to their
-`.safetensors`: the engine builds each flow model on the `meta` device from that
+4.28 GB, seven files, plus `multivue/cameras/` — DA3-BASE and the code that
+reads it, 544 MB, Apache-2.0, unchanged. Keep the three `.json` descriptors
+next to their `.safetensors`: the engine builds each flow model on the `meta` device from that
 descriptor, then loads the tensors in place, so the weights are never held
 twice. The descriptors declare `dtype: float8_e4m3fn`.
 
@@ -74,33 +90,39 @@ Set `LOCALMESH_ROOT` to the folder that holds `models/`, then:
 
 ```bash
 pip install -U huggingface_hub
-hf download Qtn-Cls/LocalMeshEngine --local-dir "$LOCALMESH_ROOT/models/multivue"
+hf download Qtn-Cls/LocalMeshEngine --local-dir "$LOCALMESH_ROOT/models"
 ```
 
-This repository is flat, so the seven files land exactly where the engine looks
-for them. There is nothing to move afterwards.
+13.1 GB, and every file lands exactly where the engine looks for it. There is
+nothing to move afterwards. For the single photo path alone, 8.3 GB, add
+`--exclude "multivue/*"`.
+
+**Then ask Meta for DINOv3**, the one set that is not here and cannot be: it is
+gated, and a human grants access. Nothing generates without it, and approval is
+not instant, so send the request before anything else —
+[facebook/dinov3-vitl16-pretrain-lvd1689m](https://huggingface.co/facebook/dinov3-vitl16-pretrain-lvd1689m).
 
 The layout the engine reads:
 
 ```
 <LOCALMESH_ROOT>/models/
-  TRELLIS.2-4B/                              pipeline.json (or pipeline_fp8.json), ckpts_fp8/
-  microsoft/TRELLIS-image-large/ckpts/       ss_dec_conv3d_16l8_fp16.json + .safetensors
-  facebook/dinov3-vitl16-pretrain-lvd1689m/
+  TRELLIS.2-4B/                              this repository
+  microsoft/TRELLIS-image-large/ckpts/       this repository
   multivue/                                  this repository
-  multivue/cameras/                          DA3-BASE, model.safetensors + config.json
+  multivue/cameras/                          this repository, DA3-BASE
+  facebook/dinov3-vitl16-pretrain-lvd1689m/  from Meta, gated
   hf/                                        Hugging Face cache (HF_HOME), where BiRefNet_HR lands
 ```
 
 Then, from the four sides of one subject:
 
 ```bash
-python -m localmesh_engine face.png --droite right.png --gauche left.png --dos back.png --vers out/
+python -m localmesh_engine face.png --right right.png --left left.png --back back.png --to out/
 ```
 
-`--palier` picks the tier: `draft`, `standard`, `high` or `max`, written
+`--tier` picks the tier: `draft`, `standard`, `high` or `max`, written
 Draft, Standard, Detailed and Extreme where these pages spell them out.
-`--graine` sets the seed, `--vers` the output folder. The command assumes the package is installed.
+`--seed` sets the seed, `--to` the output folder. The command assumes the package is installed.
 The four view path also needs `natten`. Installation, including the three CUDA
 extensions that are not on PyPI, is written up in `docs/INSTALL.md` in the
 GitHub repository; the four tiers, frozen, are in `docs/RECIPES.md`.