VRGaussianAvatar

Official implementation of “VRGaussianAvatar: Integrating 3D Gaussian Avatars into VR.”

This repository contains an end-to-end system for driving and rendering full-body 3D Gaussian Splatting (3DGS) avatars in VR. The system is split into:

• GA Backend (Python): renders a one-shot reconstructed 3D Gaussian avatar using the streamed pose and camera/view parameters.
• VR Frontend (Unity): runs in the VR runtime, obtains user motion/view signals from the HMD, and streams them to the backend. The rendered results are received back and displayed in VR.

---

Repository Structure

VRGaussianAvatar/
├─ VRGaussianAvatar_GABackend/ # Python project (GA Backend)
│ ├─ experiments/
│ └─ LHM/
└─ VRGaussianAvatar_VRFrontend/ # Unity project (VR Frontend)
├─ Assets/
├─ ProjectSettings/
└─ Packages/ (Unity will manage this)

---

Quick Start (Localhost)

1) GA Backend (Python)

The GA Backend is self-contained under VRGaussianAvatar_GABackend/. It is highly recommended to use the provided install.bat script to set up the environment, as it handles specific versions of Torch, PyTorch3D, and other dependencies.

Setup & Run:

cd VRGaussianAvatar_GABackend

# 1. Create and activate virtual environment
python -m venv .venv
# Windows (PowerShell)
.venv\Scripts\Activate.ps1

# 2. Install dependencies (Windows)
# This script installs Torch 2.3.0, PyTorch3D, SAM2, etc.
# For the other depencency issues, please refer the LHM repository
# https://github.com/aigc3d/LHM
.\install.bat

# 3. Run the server
python main_server_dual.py

Notes:

If the backend provides additional setup docs/scripts (e.g., model downloads, environment variables, config files), use the ones inside VRGaussianAvatar_GABackend/.

Run the backend first before launching the Unity frontend.

2) VR Frontend (Unity)

Unity version: 6000.1.13f1

Setup

1. Download the Main Scene:

   • Download C1_Self_Client.unity from Google Drive.
   • Place it in: VRGaussianAvatar_VRFrontend/Assets/VRGA/Scene/.

2. Open Unity Hub.

3. Click Open and select the folder:

   • VRGaussianAvatar_VRFrontend/

4. Ensure the project is opened with Unity 6000.1.13f1.

5. Open the scene Assets/VRGA/Scene/C1_Self_Client.unity.

6. Run the project under the VR Front Link setting (Link-based PCVR execution).

---

Typical Workflow (Localhost)

1. Start GA Backend on your machine (localhost).
2. Open and run VR Frontend in Unity using Link mode.
3. The frontend streams pose/view parameters to the backend.
4. The backend renders the 3D Gaussian avatar and streams frames back.
5. The frontend displays the returned rendering in VR.

---

Citation

If you use this codebase in academic work, please cite the corresponding paper:

# The main citation bibtex will be available soon!

# We use the LHM as a backend for the 3D Gaussian avatar rendering.
@inproceedings{qiu2025LHM,
  title={LHM: Large Animatable Human Reconstruction Model from a Single Image in Seconds},
  author={Lingteng Qiu and Xiaodong Gu and Peihao Li  and Qi Zuo
     and Weichao Shen and Junfei Zhang and Kejie Qiu and Weihao Yuan
     and Guanying Chen and Zilong Dong and Liefeng Bo 
    },
  booktitle={arXiv preprint arXiv:2503.10625},
  year={2025}
}