Add ScaleNav model card and checkpoint configuration
Browse files- README.md +81 -0
- SHA256SUMS.json +6 -0
- transformer/config.json +39 -0
README.md
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language:
|
| 3 |
+
- en
|
| 4 |
+
base_model: Wan-AI/Wan2.2-TI2V-5B
|
| 5 |
+
base_model_relation: finetune
|
| 6 |
+
tags:
|
| 7 |
+
- robotics
|
| 8 |
+
- navigation
|
| 9 |
+
- video-diffusion
|
| 10 |
+
- image-text-to-action
|
| 11 |
+
- safetensors
|
| 12 |
+
---
|
| 13 |
+
|
| 14 |
+
# ScaleNav
|
| 15 |
+
|
| 16 |
+
**Scalable Internet Video Pretraining for Language-Conditioned Local Navigation**
|
| 17 |
+
|
| 18 |
+
[Code](https://github.com/yangyihui0502/ScaleNav) · [Project page](https://yangyihui0502.github.io/scalenav-review/)
|
| 19 |
+
|
| 20 |
+
ScaleNav learns navigation priors from Internet videos through action-free
|
| 21 |
+
pretraining, then predicts local actions and future observations conditioned on
|
| 22 |
+
RGB observations and a navigation instruction.
|
| 23 |
+
|
| 24 |
+
## Download
|
| 25 |
+
|
| 26 |
+
Download the checkpoint from the [GitHub release](https://github.com/yangyihui0502/ScaleNav/releases/tag/scalenav-v1).
|
| 27 |
+
From the ScaleNav code repository:
|
| 28 |
+
|
| 29 |
+
```bash
|
| 30 |
+
python scripts/download_checkpoint.py --output checkpoints/scalenav
|
| 31 |
+
```
|
| 32 |
+
|
| 33 |
+
This Hub repository provides the model card, architecture configuration and
|
| 34 |
+
file checksums.
|
| 35 |
+
|
| 36 |
+
Download the Wan VAE, text encoder and tokenizer using the
|
| 37 |
+
[installation and checkpoint guide](https://github.com/yangyihui0502/ScaleNav#checkpoints).
|
| 38 |
+
|
| 39 |
+
## Inference
|
| 40 |
+
|
| 41 |
+
After installing the ScaleNav code and preparing an observation:
|
| 42 |
+
|
| 43 |
+
```bash
|
| 44 |
+
awm check --checkpoint checkpoints/scalenav --sha256
|
| 45 |
+
awm infer --checkpoint checkpoints/scalenav \
|
| 46 |
+
--base-model checkpoints/Wan2.2-TI2V-5B \
|
| 47 |
+
--image data/example/observation.png \
|
| 48 |
+
--prompt 'Approach the chair beside the table.' --output outputs/example
|
| 49 |
+
```
|
| 50 |
+
|
| 51 |
+
This produces a nine-step action trajectory and a generated video. Actions are
|
| 52 |
+
per-frame forward/right/clockwise-yaw displacements in metres/metres/radians.
|
| 53 |
+
Continuous navigation uses incoming camera frames through
|
| 54 |
+
[`awm serve`](https://github.com/yangyihui0502/ScaleNav/blob/main/docs/INFERENCE.md).
|
| 55 |
+
|
| 56 |
+
## Model settings
|
| 57 |
+
|
| 58 |
+
| Setting | Value |
|
| 59 |
+
| --- | --- |
|
| 60 |
+
| Observation size | 288 × 512 |
|
| 61 |
+
| Observation/action rate | 4 Hz |
|
| 62 |
+
| Chunk length | 9 frames |
|
| 63 |
+
| Sampling steps | 4 |
|
| 64 |
+
| Video / action guidance | 5 / 1 |
|
| 65 |
+
| Video / action scheduler shifts | 5 / 1 |
|
| 66 |
+
| History | Initial-frame anchor and two recent chunks |
|
| 67 |
+
| Action normalization | Symlog, c = 0.01 |
|
| 68 |
+
|
| 69 |
+
## Checkpoint contents
|
| 70 |
+
|
| 71 |
+
| File | Contents |
|
| 72 |
+
| --- | --- |
|
| 73 |
+
| `transformer/diffusion_pytorch_model.safetensors` | ScaleNav model weights |
|
| 74 |
+
| `transformer/config.json` | Model architecture |
|
| 75 |
+
| `train_meta.pt`, `ar_model.pt` | Deployment metadata |
|
| 76 |
+
| `SHA256SUMS.json` | File checksums |
|
| 77 |
+
|
| 78 |
+
Total checkpoint size: **10.02 GB**. The separate Wan components occupy about
|
| 79 |
+
14.2 GB. The code repository includes [training](https://github.com/yangyihui0502/ScaleNav/blob/main/docs/TRAINING.md),
|
| 80 |
+
[evaluation](https://github.com/yangyihui0502/ScaleNav/blob/main/docs/EVALUATION.md)
|
| 81 |
+
and [trajectory visualization](https://github.com/yangyihui0502/ScaleNav#inference).
|
SHA256SUMS.json
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"ar_model.pt": "7e8d953987c3d6c24eb90da5b576e7fd8cc014ebb61819d980ffbd75524d057f",
|
| 3 |
+
"train_meta.pt": "35528281fb59deaa6ede1b18ab6c7b30aa7751e515337f14a77a7871931ffaf0",
|
| 4 |
+
"transformer/config.json": "c8061133ae831595a98104f7f4fb1d4c85d83f2745842301eca34b89967b45c6",
|
| 5 |
+
"transformer/diffusion_pytorch_model.safetensors": "d66cc8e698ac201646d832e190dac65deaa616bd1a8d3f1c844248aef155035d"
|
| 6 |
+
}
|
transformer/config.json
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"_class_name": "CausalChunkDiTModel",
|
| 3 |
+
"_diffusers_version": "0.37.1",
|
| 4 |
+
"action_dim": 3,
|
| 5 |
+
"action_temporal_scale": 1.0,
|
| 6 |
+
"chunk_overlap_frames": 0,
|
| 7 |
+
"cross_attn_norm": true,
|
| 8 |
+
"cross_attn_type": "cross_attn",
|
| 9 |
+
"dim": 3072,
|
| 10 |
+
"eps": 1e-06,
|
| 11 |
+
"ffn_dim": 14336,
|
| 12 |
+
"freq_dim": 256,
|
| 13 |
+
"hidden_size": 3072,
|
| 14 |
+
"in_channels": 48,
|
| 15 |
+
"in_dim": 48,
|
| 16 |
+
"max_attn_chunks": 4,
|
| 17 |
+
"model_type": "ti2v",
|
| 18 |
+
"num_heads": 24,
|
| 19 |
+
"num_layers": 30,
|
| 20 |
+
"num_special_tokens": 8,
|
| 21 |
+
"out_dim": 48,
|
| 22 |
+
"patch_size": [
|
| 23 |
+
1,
|
| 24 |
+
2,
|
| 25 |
+
2
|
| 26 |
+
],
|
| 27 |
+
"qk_norm": true,
|
| 28 |
+
"special_memory_recent_chunks": 2,
|
| 29 |
+
"text_dim": 4096,
|
| 30 |
+
"text_len": 512,
|
| 31 |
+
"traj_head_hidden_dim": 768,
|
| 32 |
+
"traj_head_type": "deep",
|
| 33 |
+
"use_continuous_history": true,
|
| 34 |
+
"use_special_memory": false,
|
| 35 |
+
"window_size": [
|
| 36 |
+
-1,
|
| 37 |
+
-1
|
| 38 |
+
]
|
| 39 |
+
}
|