wwhyyyyyy commited on
Commit
5f29fd0
·
verified ·
1 Parent(s): ec61a02

Add GeneralVLA-2 training-free deployment manifest

Browse files
Files changed (3) hide show
  1. README.md +90 -0
  2. asset_manifest.json +47 -0
  3. generalvla2.yaml +26 -0
README.md ADDED
@@ -0,0 +1,90 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ language:
4
+ - en
5
+ - zh
6
+ library_name: pytorch
7
+ tags:
8
+ - robotics
9
+ - vision-language-action
10
+ - robot-planning
11
+ - 3d-reconstruction
12
+ - long-term-memory
13
+ - training-free
14
+ ---
15
+
16
+ # GeneralVLA-2: Geometry-Aware Reconstruction and Governed Memory for Robot Planning
17
+
18
+ GeneralVLA-2 is a training-free, planner-facing extension of GeneralVLA. It improves the two evidence sources used by the 3D planning agent:
19
+
20
+ 1. **GeoFuse-MV3D** supplies conservative, mask-verified, appearance-preserving object geometry from calibrated multi-view observations.
21
+ 2. **Governed KnowledgeBank** supplies quality-, confidence-, lifecycle-, conflict-, and geometry-aware experience retrieval.
22
+
23
+ The project keeps the original hierarchical interface: affordance perception, 3D trajectory planning, and low-level robot execution.
24
+
25
+ ## Important: checkpoint scope
26
+
27
+ GeneralVLA-2 does **not** introduce a newly trained monolithic checkpoint. Its contributions operate at reconstruction and planning time without updating model parameters. This repository therefore provides the official deployment manifest and configuration instead of duplicating approximately 40 GB of base and third-party checkpoints.
28
+
29
+ The GeneralVLA project assets are hosted at:
30
+
31
+ - [AIGeeksGroup/GeneralVLA](https://huggingface.co/AIGeeksGroup/GeneralVLA)
32
+
33
+ Additional upstream assets used by GeoFuse-MV3D, such as SAM 3D Objects and VGGT, must be obtained from their official releases. See `asset_manifest.json` for the complete provenance and purpose of each dependency.
34
+
35
+ ## Code and project page
36
+
37
+ - Code: https://github.com/AIGeeksGroup/GeneralVLA-2
38
+ - Project page: https://aigeeksgroup.github.io/GeneralVLA-2
39
+ - Paper: https://arxiv.org/abs/2606.17480
40
+
41
+ ## Setup
42
+
43
+ ```bash
44
+ git clone https://github.com/AIGeeksGroup/GeneralVLA-2.git
45
+ cd GeneralVLA-2/GeneralVLA
46
+
47
+ hf download AIGeeksGroup/GeneralVLA \
48
+ --local-dir vendor/GeneralVLA/pretrain_model
49
+
50
+ bash scripts/bootstrap.sh
51
+ PYTHONPATH=src python -m robot_memory_vla.app.main \
52
+ --preflight \
53
+ --config-dir ./configs
54
+ ```
55
+
56
+ The checked-in GitHub configuration already uses repository-relative paths. `generalvla2.yaml` in this model repository records the matching asset layout in a compact deployment-oriented form.
57
+
58
+ ## Base assets
59
+
60
+ The GeneralVLA asset repository contains:
61
+
62
+ - `LISA-7B-v1-explanatory`: language and segmentation reasoning checkpoint.
63
+ - `segagent/zzzmmz/SegAgent-Model`: visual grounding model.
64
+ - `sam_vit_h_4b8939.pth`: SAM ViT-H segmentation checkpoint.
65
+ - `clip-vit-large-patch14`: CLIP vision-language encoder.
66
+ - `checkpoints/v1/checkpoint-rs.tar`: GraspNet checkpoint used by the robot stack.
67
+
68
+ These assets retain their own upstream licenses and terms. The Apache-2.0 metadata on this repository applies to the GeneralVLA-2 configuration and documentation, not to independently distributed third-party checkpoints.
69
+
70
+ ## Reported results
71
+
72
+ - On GSO-30, GeoFuse-MV3D reduces CD and LPIPS by 2.20% and 2.02%, while increasing PSNR and SSIM by 2.36% and 1.03% over the MV-SAM3D baseline under the same input-view protocol.
73
+ - Governed KnowledgeBank improves over ReasoningBank by 4.53% on Terminal-Bench 2.0 success rate and 3.73% on SWE-Bench Verified resolve rate, while reducing average steps by 4.95% and 5.65%.
74
+ - GeneralVLA-2 produces successful trajectories on all 14 evaluated RLBench tasks without parameter training and is best among the compared methods on 10 tasks.
75
+
76
+ ## 中文说明
77
+
78
+ GeneralVLA-2 的新增贡献是训练无关的多视图几何增强与长期记忆治理,不对应一套重新训练的大模型权重。本仓库提供官方模型入口、部署配置和资产来源清单;实际运行时请从 `AIGeeksGroup/GeneralVLA` 下载基础权重,并按照 GitHub 仓库中各组件的说明准备 GeoFuse-MV3D 所需的官方上游资产。
79
+
80
+ ## Citation
81
+
82
+ ```bibtex
83
+ @article{wang2026generalvla2,
84
+ title={GeneralVLA-2: Geometry-Aware Reconstruction and Governed Memory for Robot Planning},
85
+ author={Wang, Haoyu and Ma, Guoqing and Zhang, Zeyu and Guo, Yandong and Shi, Boxin and Tang, Hao},
86
+ journal={arXiv preprint arXiv:2606.17480},
87
+ year={2026}
88
+ }
89
+ ```
90
+
asset_manifest.json ADDED
@@ -0,0 +1,47 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "project": "GeneralVLA-2",
3
+ "checkpoint_scope": "training-free planner and reconstruction extensions; no newly trained monolithic checkpoint",
4
+ "code_repository": "https://github.com/AIGeeksGroup/GeneralVLA-2",
5
+ "base_asset_repository": "AIGeeksGroup/GeneralVLA",
6
+ "base_assets": [
7
+ {
8
+ "path": "LISA-7B-v1-explanatory",
9
+ "purpose": "language and segmentation reasoning",
10
+ "source": "AIGeeksGroup/GeneralVLA"
11
+ },
12
+ {
13
+ "path": "segagent/zzzmmz/SegAgent-Model",
14
+ "purpose": "visual grounding",
15
+ "source": "AIGeeksGroup/GeneralVLA"
16
+ },
17
+ {
18
+ "path": "sam_vit_h_4b8939.pth",
19
+ "purpose": "SAM ViT-H segmentation",
20
+ "source": "AIGeeksGroup/GeneralVLA"
21
+ },
22
+ {
23
+ "path": "clip-vit-large-patch14",
24
+ "purpose": "vision-language encoding",
25
+ "source": "AIGeeksGroup/GeneralVLA"
26
+ },
27
+ {
28
+ "path": "checkpoints/v1/checkpoint-rs.tar",
29
+ "purpose": "GraspNet robot grasping checkpoint",
30
+ "source": "AIGeeksGroup/GeneralVLA"
31
+ }
32
+ ],
33
+ "geofuse_upstream_assets": [
34
+ {
35
+ "repository": "facebook/sam-3d-objects",
36
+ "purpose": "SAM 3D Objects checkpoint and reconstruction runtime"
37
+ },
38
+ {
39
+ "repository": "facebook/VGGT-1B",
40
+ "purpose": "optional geometry-prior provider"
41
+ }
42
+ ],
43
+ "notes": [
44
+ "Third-party checkpoints retain their own licenses and access terms.",
45
+ "Generated PLY files and benchmark outputs are evaluation artifacts, not model weights."
46
+ ]
47
+ }
generalvla2.yaml ADDED
@@ -0,0 +1,26 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ project:
2
+ name: GeneralVLA-2
3
+ code_repository: https://github.com/AIGeeksGroup/GeneralVLA-2
4
+ base_asset_repository: AIGeeksGroup/GeneralVLA
5
+ parameter_update_required: false
6
+
7
+ runtime:
8
+ precision: fp16
9
+ load_in_4bit: true
10
+ device: cuda:0
11
+ retrieval_backend: simple
12
+ retrieval_top_k: 3
13
+ require_operator_confirmation: true
14
+
15
+ assets:
16
+ lisa: vendor/GeneralVLA/pretrain_model/LISA-7B-v1-explanatory
17
+ segagent: vendor/GeneralVLA/pretrain_model/segagent/zzzmmz/SegAgent-Model
18
+ sam_vit_h: vendor/GeneralVLA/pretrain_model/sam_vit_h_4b8939.pth
19
+ clip: vendor/GeneralVLA/pretrain_model/clip-vit-large-patch14
20
+ graspnet: vendor/GeneralVLA/pretrain_model/checkpoints/v1/checkpoint-rs.tar
21
+
22
+ components:
23
+ generalvla_runtime: GeneralVLA
24
+ geometry_reconstruction: GeoFuse-MV3D
25
+ governed_memory: KnowledgeBank
26
+