Other

项目介绍

Zielon/INSTA 是一个托管在 GitHub 上的开源项目,主要使用 C++ 编写,采用 Other 许可证,目前获得 523 个 Star、44 次 Fork。

仓库全名
Zielon/INSTA
开源许可证
Other
Star 数
523
Fork 数
44
未关闭 Issue
4

README 摘要

INSTA - Instant Volumetric Head Avatars Wojciech Zielonka , Timo Bolkart , Justus Thies Max Planck Institute for Intelligent Systems, Tübingen, Germany Video&nbsp Paper&nbsp Project Website&nbsp Dataset&nbsp Face Tracker&nbsp INSTA Pytorch&nbsp Email Official Repository for CVPR 2023 paper Instant Volumetric Head Avatars This repository is based on instant-ngp, some of the features of the original code are not…

完整内容见 GitHub 原始 README 或本页 。

常见问题

INSTA 用什么语言开发?

主要使用 C++ 编写,采用 Other 许可证,目前有 523 个 Star。

INSTA 可以免费商用吗?

仓库标注的许可证为 Other,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 INSTA 的源码?

可以直接克隆仓库:git clone https://github.com/Zielon/INSTA.git,默认分支为 master;安装与运行步骤见仓库 README。

INSTA 最近还在维护吗?

仓库最近一次更新为 2025年8月3日,当前有 4 个未关闭 Issue;Star 数为 523,可作为社区活跃度的参考。

关于

INSTA - Instant Volumetric Head Avatars [CVPR2023]

描述取自 GitHub 官方 API,中文内容由 GitRead 中文社区 编辑团队整理。

简要分析

热度分
630
价值分
328
活跃状态
活跃

语言占比

Batchfile
C
C++
CMake
Cuda
HTML
JavaScript
Lua
Makefile
PowerShell
Python
Shell
TeX

贡献者

README

INSTA - Instant Volumetric Head Avatars

Wojciech Zielonka, Timo Bolkart, Justus Thies
Max Planck Institute for Intelligent Systems, Tübingen, Germany
Video  Paper  Project Website  Dataset  Face Tracker  INSTA Pytorch  Email

Official Repository for CVPR 2023 paper Instant Volumetric Head Avatars

This repository is based on instant-ngp, some of the features of the original code are not available in this work.

⚠ We also prepared a Pytorch demo version of the project INSTA Pytorch  ⚠

Installation

The repository is based on instant-ngp commit. The requirements for the installation are the same, therefore please follow the guide. Remember to use the --recursive option during cloning.

git clone --recursive https://github.com/Zielon/INSTA.git
cd INSTA
cmake . -B build
cmake --build build --config RelWithDebInfo -j

Usage and Requirements

After building the project you can either start training an avatar from scratch or load a snapshot. For training, we recommend a graphics card higher or equal to RTX3090 24GB and 32 GB of RAM memory. Training on a different hardware probably requires adjusting options in the config:

  "max_cached_bvh": 4000,            # How many BVH data structures are cached
  "max_images_gpu": 1700,            # How many frames are loaded to GPU. Adjust for a given GPU memory size.
  "use_dataset_cache": true,         # Load images to RAM memory
  "max_steps": 33000,                # Max training steps after which test sequence will be recorded
  "render_novel_trajectory": false,  # Dumps additional camera trajectories after max steps
  "render_from_snapshot": false      # For --no-gui option to directly render sequences

Rendering from a snapshot does not require a high-end GPU and can be performed even on a laptop. We have tested it on RTX 3080 8GB laptop version. For --no-gui option you can train and load snapshot for rendering by using the config in the same way as the one with GUI. The viewer options are the same as in the case of instant-ngp, with some additional key F to raycast the FLAME mesh.

Usage example

# Run without GUI examples script
./run.sh

# Run cross reenactment based on deformation gradient transfer
./run_transfer.sh

# Training with GUI
./build/rta --config insta.json --scene data/obama --height 512 --width 512

# Loading from a checkpoint
./build/rta --config insta.json --scene data/obama/transforms_test.json --snapshot data/obama/snapshot.msgpack

For better visualization you can use our GUI application.

Dataset and Training

We are releasing part of our dataset together with publicly available preprocessed avatars from NHA, NeRFace and IMAvatar. Each participant whose data was recorded in this study provided written consent for its release by signing this document. Access to those sequences can be requested via Google Forms.

Available avatars. Click the selected avatar to download the training dataset and the checkpoint. The avatars have to be placed in the data folder.

The output of the training (Record Video in menu), including rendered frames, checkpoint, etc will be saved in the ./data/{actor}/experiments/{config}/debug. After the specified number of max steps, the program will automatically either render frames using novel cameras (All option in GUI and render_novel_trajectory in config) or only the currently selected one in Mode, by default Overlay\Test.

Dataset Generation

For the input generation, a conda environment is needed, and a few other repositories. Simply run install.sh from scripts folder to prepare the workbench.

Next, you can use Metrical Photometric Tracker for the tracking of a sequence. After the processing is done run the generate.sh script to prepare the sequence. As input please specify the absolute path of the tracker output.

For training we recommend at least 1000 frames.

# 1) Run the Metrical Photometric Tracker for a selected actor
python tracker.py --cfg ./configs/actors/duda.yml

# 2) Generate a dataset using the script. Importantly, use the absolute path to tracker input and desired output.
./generate.sh /metrical-tracker/output/duda INSTA/data/duda 100
#                        {input}                {output}    {# of test frames from the end}

Citation

If you use this project in your research please cite INSTA:

@proceedings{INSTA:CVPR2023,
  author = {Zielonka, Wojciech and Bolkart, Timo and Thies, Justus},
  title = {Instant Volumetric Head Avatars},
  journal = {Conference on Computer Vision and Pattern Recognition},
  year = {2023}
}

评论

暂无评论