Instructions to use google/tapnet with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use google/tapnet with Transformers:
# pip install -U transformers accelerate # Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("google/tapnet", device_map="auto") - Notebooks
- Google Colab
- Kaggle
Update Model Card with complete checkpoint listing, license, and usage examples
Browse files
README.md
CHANGED
|
@@ -1,22 +1,197 @@
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
| 3 |
tags:
|
| 4 |
-
- vision
|
| 5 |
-
- tracking
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 6 |
---
|
| 7 |
|
| 8 |
-
#
|
| 9 |
|
| 10 |
-
|
| 11 |
|
| 12 |
-
|
| 13 |
|
| 14 |
-
##
|
| 15 |
|
| 16 |
-
|
| 17 |
|
| 18 |
-
|
| 19 |
-
|
| 20 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 21 |
|
| 22 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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.
|