NavGPT3-4B / README.md
ZGZzz's picture
update readme
782538e verified
|
Raw History Blame Contribute Delete
4.91 kB
---
license: agpl-3.0
base_model:
- Qwen/Qwen3-VL-4B-Instruct
base_model_relation: finetune
pipeline_tag: robotics
language:
- en
tags:
- vision-language-navigation
- vision-language-action
- embodied-ai
- qwen3-vl
---
# NavGPT3-4B
NavGPT3-4B is the 4B NavGPT VLA, the low-level navigation policy of
NavGPT-3. Given a natural-language instruction and a history of four-view RGB
observations (front, right, back, left), it predicts the next eight waypoints.
In NavGPT-3, a Planner chooses the instructions and decides when to stop; the
VLA carries them out.
## Resources
- Paper: [NavGPT-3: Harnessing Context in a Hierarchical Navigation Runtime](https://arxiv.org/abs/2610.10787)
- Code: [metacognitionai/NavGPT-3](https://github.com/metacognitionai/NavGPT-3)
- Other size: [NavGPT3-8B](https://huggingface.co/Metacognition-AI/NavGPT3-8B)
## Model details
| | |
|---|---|
| Base model | [Qwen3-VL-4B-Instruct](https://huggingface.co/Qwen/Qwen3-VL-4B-Instruct) |
| Parameters | 4.44B, BF16 |
| Action head | Two-layer MLP on the final hidden state of the last prompt token; outputs 8 waypoints of (x, y, θ), normalised |
| Observations | Up to 16 history steps × 4 views, 400×400 at 120° field of view |
| Visual tokens | One budget of 3,072 tokens shared by all images, split per image by recency, camera and how much the frame changed |
| Training data | About 19.28M examples: vision-and-language navigation, embodied navigation QA, cross-embodiment navigation and grounding |
| Code | NavGPT3 classes on Transformers 5.18 |
## Results
Vision-and-language navigation on the R2R-CE and RxR-CE Val-Unseen splits, as
reported in the [NavGPT-3 paper](https://arxiv.org/abs/2610.10787). The NavGPT3 rows are the model on its own,
without the NavGPT-3 Planner.
| Method | Size | R2R NE↓ | R2R OSR↑ | R2R SR↑ | R2R SPL↑ | RxR NE↓ | RxR nDTW↑ | RxR SR↑ | RxR SPL↑ |
|---|---|---:|---:|---:|---:|---:|---:|---:|---:|
| NavFoM | 7B | 4.61 | 72.1 | 61.7 | 55.3 | 4.74 | 65.8 | 64.4 | 56.2 |
| ABot-N0 | 4B | 3.78 | 70.8 | 66.4 | 63.9 | 3.83 | – | 69.3 | 60.0 |
| AstraNav-World | 3B+5B | 3.86 | 73.9 | 67.9 | 65.4 | 3.82 | – | 72.9 | 61.5 |
| OmniNav | 3B | 3.74 | 74.6 | 69.5 | 66.1 | 3.77 | – | 73.6 | 62.0 |
| Qwen-RobotNav | 4B | 3.80 | 77.2 | 69.5 | 63.6 | 3.80 | 71.9 | 75.2 | 65.0 |
| Qwen-RobotNav | 8B | 3.53 | 78.5 | 72.1 | 66.6 | 3.58 | 72.5 | 76.5 | 65.7 |
| Robostral Navigate | 8B | 3.20 | 81.3 | 77.4 | 74.2 | 3.47 | – | 75.1 | 68.7 |
| **NavGPT3-4B** | **4B** | **3.32** | **81.67** | **74.33** | **68.13** | **2.87** | **75.79** | **81.41** | **69.86** |
| NavGPT3-8B | 8B | 2.97 | 82.49 | 76.94 | 70.61 | 2.65 | 76.74 | 82.39 | 70.56 |
Full evaluation trajectories and per-episode results are available in the [evaluation files](https://huggingface.co/datasets/ZGZzz/NavGPT-3-website-media/tree/main/evaluation).
NE is navigation error in metres; OSR (oracle success), SR (success), SPL (success
weighted by path length) and nDTW (path fidelity) are percentages.
In the complete NavGPT-3 system, where a Planner directs NavGPT3-8B, success
rises to 81.51 SR on R2R-CE and 90.43 SR on RxR-CE.
## Usage
The model needs the NavGPT3 classes from the
[NavGPT-3 repository](https://github.com/metacognitionai/NavGPT-3); it does not
load with `AutoModel` alone.
```bash
hf download Metacognition-AI/NavGPT3-4B --local-dir checkpoints/NavGPT3-4B
```
```python
from navgpt.vla.runtime import load_from_pretrained
model, processor = load_from_pretrained("checkpoints/NavGPT3-4B", device="cuda")
```
`model.predict_actions(**inputs)` returns the normalised waypoints for processor
outputs. The `navgpt.vla` agent keeps the multi-view history, assigns the
per-image token budgets and scales the waypoints to metres and radians. To serve
the model for Habitat evaluation, set its directory in `configs/paths.yaml` and run
`python -m navgpt.vla --config configs/experiments/vln/vla_4b_r2r.yaml`.
## Limitations
- Trained and evaluated in Habitat simulation (R2R-CE, RxR-CE). Waypoint scales
follow the simulated embodiment; other robots need their own scales and testing.
- Evaluated on English instructions.
## License
The weights are released under the [GNU Affero General Public License v3.0](LICENSE).
They are fine-tuned from [Qwen3-VL-4B-Instruct](https://huggingface.co/Qwen/Qwen3-VL-4B-Instruct), released by
the Qwen team under the [Apache License 2.0](LICENSE-Apache-2.0); see [NOTICE](NOTICE).
The NavGPT-3 source code is licensed separately.
## Citation
```bibtex
@article{zhou2026navgpt3,
title={NavGPT-3: Harnessing Context in a Hierarchical Navigation Runtime},
author={Zhou, Gengze and Hong, Yicong and Zhang, Jiazhao and Zhao, Xunyi and Zhou, Jian and Lei, Zixing and Wang, Zun and Zhao, Chongyang and Chen, Xionghui and Gould, Stephen and van den Hengel, Anton and Wu, Qi},
journal={arXiv preprint arXiv:2610.10787},
year={2026}
}
```