yangyi02 commited on
Commit
52501fe
·
verified ·
1 Parent(s): 45ac0ce

Update Model Card with complete checkpoint listing, license, and usage examples

Browse files
Files changed (1) hide show
  1. README.md +186 -11
README.md CHANGED
@@ -1,22 +1,197 @@
1
  ---
2
  license: apache-2.0
3
  tags:
4
- - vision
5
- - tracking
 
 
 
 
 
 
 
 
 
 
 
6
  ---
7
 
8
- # TAPNet
9
 
10
- This repository contains the checkpoints of several point tracking models developed by DeepMind for point tracking.
11
 
12
- 🔗 **Code**: [https://github.com/google-deepmind/tapnet](https://github.com/google-deepmind/tapnet)
13
 
14
- ## Included Models
15
 
16
- [**TAPIR**](https://deepmind-tapir.github.io/) – A fast and accurate point tracker for continuous point trajectories in space-time, presented in the paper [**TAPIR: Tracking Any Point with per-frame Initialization and temporal Refinement**](https://huggingface.co/papers/2306.08637).
17
 
18
- [**BootsTAPIR**](https://bootstap.github.io/) – A bootstrapped variant of TAPIR that improves robustness and stability across long videos via self-supervised refinement, presented in the paper [**BootsTAP: Bootstrapped Training for Tracking-Any-Point**](https://huggingface.co/papers/2402.00847).
19
-
20
- [**TAPNext**](https://tap-next.github.io/) – A new generative approach that frames point tracking as next-token prediction, enabling semi-dense, accurate, and temporally coherent tracking across challenging videos, presented in the paper [**TAPNext: Tracking Any Point (TAP) as Next Token Prediction**](https://huggingface.co/papers/2504.05579).
 
 
 
 
 
21
 
22
- These models provide state-of-the-art performance for tracking arbitrary points in videos and support research and applications in robotics, perception, and video generation.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  license: apache-2.0
3
  tags:
4
+ - vision
5
+ - tracking
6
+ - point-tracking
7
+ - video
8
+ - pytorch
9
+ - jax
10
+ library_name: transformers
11
+ arxiv:
12
+ - "2211.03726"
13
+ - "2306.08637"
14
+ - "2402.00847"
15
+ - "2504.05579"
16
+ - "2604.10582"
17
  ---
18
 
19
+ # Tracking Any Point (TAP) — Model Checkpoints
20
 
21
+ Official pre-trained checkpoints for the **Tracking Any Point (TAP)** family of models from Google DeepMind & Google Research.
22
 
23
+ [[GitHub](https://github.com/google-deepmind/tapnet)] [[TAP-Vid](https://tapvid.github.io/)] [[TAPIR](https://deepmind-tapir.github.io/)] [[BootsTAP](https://bootstap.github.io/)] [[TAPNext](https://tap-next.github.io/)] [[TAPNext++](https://tap-next-plus-plus.github.io/)]
24
 
25
+ ## Model Overview
26
 
27
+ The TAP model family addresses the task of **tracking any point on any solid physical surface** across video frames. Given a query point on one frame, the model predicts where that point moves to on every other frame, along with an occlusion/visibility estimate.
28
 
29
+ | Model | Key Contribution |
30
+ |:--|:--|
31
+ | **TAP-Net** | Baseline model introduced with the TAP-Vid benchmark |
32
+ | **TAPIR** | Two-stage matching + refinement; large accuracy gains over TAP-Net |
33
+ | **BootsTAPIR** | TAPIR + bootstrapped self-training on unlabeled video |
34
+ | **TAPNext / BootsTAPNext** | Next-token-prediction formulation; fastest and simplest tracker |
35
+ | **TAPNext++** | Fine-tuned BootsTAPNext with 40× longer stable tracking, occlusion handling, and re-detection |
36
+ | **TRAJAN** | Point trajectory autoencoder for motion representation learning |
37
 
38
+ ## Checkpoints
39
+
40
+ All checkpoints are released under the **Apache License 2.0**.
41
+
42
+ ### TAPNext++ (latest)
43
+
44
+ | File | Resolution | Framework | DAVIS First (AJ) | Kinetics First (AJ) | RoboTAP First (AJ) |
45
+ |:--|:--:|:--:|:--:|:--:|:--:|
46
+ | `tapnextpp_ckpt.pt` | 256×256 | PyTorch | 65.6% | 53.9% | 61.1% |
47
+ | `tapnextpp_512.ckpt` | 512×512 | PyTorch | 67.0% | — | — |
48
+
49
+ ### TAPNext / BootsTAPNext
50
+
51
+ | File | Resolution | Framework | DAVIS First (AJ) |
52
+ |:--|:--:|:--:|:--:|
53
+ | `bootstapnext.pth` | 256×256 | PyTorch | 65.25% |
54
+ | `bootstapnext_ckpt.npz` | 256×256 | Jax | 65.25% |
55
+
56
+ ### TAPIR & BootsTAPIR
57
+
58
+ | File | Mode | Resolution | Framework | DAVIS First (AJ) |
59
+ |:--|:--:|:--:|:--:|:--:|
60
+ | `tapir_checkpoint_panning.pt` | Offline | 256×256 | PyTorch | 58.5% |
61
+ | `tapir_checkpoint_panning.npy` | Offline | 256×256 | Jax | 58.5% |
62
+ | `causal_tapir_checkpoint.npy` | Online | 256×256 | Jax | 56.2% |
63
+ | `bootstapir_checkpoint_v2.pt` | Offline | 256×256 + 512×512 | PyTorch | 62.4% |
64
+ | `bootstapir_checkpoint_v2.npy` | Offline | 256×256 + 512×512 | Jax | 62.4% |
65
+ | `causal_bootstapir_checkpoint.pt` | Online | 256×256 + 512×512 | PyTorch | 59.7% |
66
+ | `causal_bootstapir_checkpoint.npy` | Online | 256×256 + 512×512 | Jax | 59.7% |
67
+
68
+ ### Other
69
+
70
+ | File | Model | Framework |
71
+ |:--|:--|:--:|
72
+ | `checkpoint.npy` | TAP-Net (baseline) | Jax |
73
+ | `track_autoencoder_ckpt.npz` | TRAJAN | Jax |
74
+
75
+ ## Quick Start
76
+
77
+ ### TAPNext++ (PyTorch)
78
+
79
+ ```python
80
+ import torch
81
+ from tapnet.torch import tapnextpp
82
+
83
+ # Load model
84
+ model = tapnextpp.TAPNextPlusPlus()
85
+ checkpoint = torch.load("tapnextpp_ckpt.pt", map_location="cpu")
86
+ model.load_state_dict(checkpoint)
87
+ model.eval()
88
+ ```
89
+
90
+ See the [TAPNext++ Colab](https://colab.research.google.com/github/deepmind/tapnet/blob/main/colabs/torch_tapnextpp_demo.ipynb) for a complete demo.
91
+
92
+ ### BootsTAPIR (PyTorch)
93
+
94
+ ```python
95
+ import torch
96
+ from tapnet.torch import tapir_model
97
+
98
+ # Load model
99
+ model = tapir_model.ParameterizedTAPIR()
100
+ checkpoint = torch.load("bootstapir_checkpoint_v2.pt", map_location="cpu")
101
+ model.load_state_dict(checkpoint)
102
+ model.eval()
103
+ ```
104
+
105
+ See the [PyTorch TAPIR Colab](https://colab.research.google.com/github/deepmind/tapnet/blob/master/colabs/torch_tapir_demo.ipynb) for a complete demo.
106
+
107
+ ## Installation
108
+
109
+ ```bash
110
+ pip install tapnet
111
+ # or with PyTorch support
112
+ pip install "tapnet[torch]"
113
+ ```
114
+
115
+ ## Citation
116
+
117
+ If you use these models, please cite the relevant papers:
118
+
119
+ <details>
120
+ <summary>TAP-Vid (NeurIPS 2022)</summary>
121
+
122
+ ```bibtex
123
+ @article{doersch2022tap,
124
+ title={{TAP}-Vid: A Benchmark for Tracking Any Point in a Video},
125
+ author={Doersch, Carl and Gupta, Ankush and Markeeva, Larisa and Recasens, Adria and Smaira, Lucas and Aytar, Yusuf and Carreira, Joao and Zisserman, Andrew and Yang, Yi},
126
+ journal={Advances in Neural Information Processing Systems},
127
+ volume={35},
128
+ pages={13610--13626},
129
+ year={2022}
130
+ }
131
+ ```
132
+ </details>
133
+
134
+ <details>
135
+ <summary>TAPIR (ICCV 2023)</summary>
136
+
137
+ ```bibtex
138
+ @inproceedings{doersch2023tapir,
139
+ title={{TAPIR}: Tracking any point with per-frame initialization and temporal refinement},
140
+ author={Doersch, Carl and Yang, Yi and Vecerik, Mel and Gokay, Dilara and Gupta, Ankush and Aytar, Yusuf and Carreira, Joao and Zisserman, Andrew},
141
+ booktitle={Proceedings of the IEEE/CVF International Conference on Computer Vision},
142
+ pages={10061--10072},
143
+ year={2023}
144
+ }
145
+ ```
146
+ </details>
147
+
148
+ <details>
149
+ <summary>BootsTAP (ACCV 2024)</summary>
150
+
151
+ ```bibtex
152
+ @article{doersch2024bootstap,
153
+ title={{BootsTAP}: Bootstrapped Training for Tracking-Any-Point},
154
+ author={Doersch, Carl and Luc, Pauline and Yang, Yi and Gokay, Dilara and Koppula, Skanda and Gupta, Ankush and Heyward, Joseph and Rocco, Ignacio and Goroshin, Ross and Carreira, Jo{\~a}o and Zisserman, Andrew},
155
+ journal={Asian Conference on Computer Vision},
156
+ year={2024}
157
+ }
158
+ ```
159
+ </details>
160
+
161
+ <details>
162
+ <summary>TAPNext (2025)</summary>
163
+
164
+ ```bibtex
165
+ @article{zholus2025tapnext,
166
+ title={TAPNext: Tracking Any Point (TAP) as Next Token Prediction},
167
+ author={Zholus, Artem and Doersch, Carl and Yang, Yi and Koppula, Skanda and Patraucean, Viorica and He, Xu Owen and Rocco, Ignacio and Sajjadi, Mehdi S. M. and Chandar, Sarath and Goroshin, Ross},
168
+ journal={arXiv preprint arXiv:2504.05579},
169
+ year={2025}
170
+ }
171
+ ```
172
+ </details>
173
+
174
+ <details>
175
+ <summary>TAPNext++ (CVPR 2026 Findings)</summary>
176
+
177
+ ```bibtex
178
+ @InProceedings{Jung_2026_CVPR,
179
+ author = {Jung, Sebastian and Zholus, Artem and Sundermeyer, Martin and Doersch, Carl
180
+ and Goroshin, Ross and Tan, David Joseph and Chandar, Sarath
181
+ and Triebel, Rudolph and Tombari, Federico},
182
+ title = {TAPNext++: What's Next for Tracking Any Point (TAP)?},
183
+ booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR) Findings},
184
+ month = {June},
185
+ year = {2026},
186
+ pages = {8429-8438}
187
+ }
188
+ ```
189
+ </details>
190
+
191
+ ## License
192
+
193
+ Copyright 2022-2026 Google LLC
194
+
195
+ All software and model checkpoints in this repository are licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
196
+
197
+ This is not an official Google product.