<div align="center"> <img src="assets/title_logo.png" width="200" alt="VMem Logo"/> <h1>VMem: Consistent Interactive Video Scene Generation with Surfel-Indexed View Memory</h1> <p align="center">ICCV 2025 ⭐ <strong>highlight</strong> ⭐</p>

<a href="https://v-mem.github.io/"><img src="https://img.shields.io/badge/%F0%9F%8F%A0%20Project%20Page-gray.svg"></a> <a href="http://arxiv.org/abs/2506.18903"><img src="https://img.shields.io/badge/%F0%9F%93%84%20arXiv-2506.18903-B31B1B.svg"></a> <a href="https://huggingface.co/liguang0115/vmem"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Model_Card-Huggingface-orange"></a> <a href="https://huggingface.co/spaces/liguang0115/vmem"><img src="https://img.shields.io/badge/%F0%9F%9A%80%20Gradio%20Demo-Huggingface-orange"></a>

Runjia Li, Philip Torr, Andrea Vedaldi, Tomas Jakab <br> <br> University of Oxford

</div> <p align="center"> <img src="assets/demo_teaser.gif" width="100%" alt="Teaser" style="border-radius:10px;"/> </p> <!-- <p align="center" border-radius="10px"> <img src="assets/benchmark.png" width="100%" alt="teaser_page1"/> </p> -->

Overview

VMem is a plug-and-play memory mechanism of image-set models for consistent scene generation. Existing methods either rely on inpainting with explicit geometry estimation, which suffers from inaccuracies, or use limited context windows in video-based approaches, leading to poor long-term coherence. To overcome these issues, we introduce Surfel Memory of Views (VMem), which anchors past views to surface elements (surfels) they observed. This enables conditioning novel view generation on the most relevant past views rather than just the most recent ones, enhancing long-term scene consistency while reducing computational cost.

:wrench: Installation

conda create -n vmem python=3.10
conda activate vmem
pip install -r requirements.txt

:rocket: Usage

You need to properly authenticate with Hugging Face to download our model weights. Once set up, our code will handle it automatically at your first run. You can authenticate by running

# This will prompt you to enter your Hugging Face credentials.
huggingface-cli login

Once authenticated, go to our model card here and enter your information for access.

We provide a demo for you to interact with VMem. Simply run

python app.py

:heart: Acknowledgement

This work is built on top of CUT3R, DUSt3R and Stable Virtual Camera. We thank them for their great works.

:books: Citing

If you find this repository useful, please consider giving a star :star: and citation.

@article{li2025vmem,
  title={VMem: Consistent Interactive Video Scene Generation with Surfel-Indexed View Memory},
  author={Li, Runjia and Torr, Philip and Vedaldi, Andrea and Jakab, Tomas},
  journal={arXiv preprint arXiv:2506.18903},
  year={2025}
}