Gaussian Splats Research

Making Gaussian Splatting research repos easier to set up and use, one Dockerfile at a time.

This is a multi-project repository focusing on making Gaussian Splatting research repositories easier to set up and use. I use Tasks and Docker for setting everything up, with Github Container Registry for housing the built images.

Pre-requisites

Install Tasks and Docker.

Usage

Create a .env file in the project root and add the path to your datasets folder:

DATA_PATH="//c/Users/fabia/Documents/_datasets"

This path will be bound to a docker volume and become available inside the containers data folder.

Important

On Windows, the path must start with two forward slashes (/): "//c/Users/fabulani/Documents/_datasets"

Type task to see all available tasks and their descriptions. You can either run the -all tasks to set up all projects, or run the tasks specific to each project. For example, to clone all repositories:

task clone-all

To work on a specific project, run the tasks associated with that project. For example, with hierarchical-3d-gaussians, the following should be enough:

task hierarchical-3d-gaussians:pull

task hierarchical-3d-gaussians:run

These will pull the image, run the container, and exec into it.

Note

Read the README.md in each project for project-specific instructions.