Add README

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,46 @@
+<div align="center">
+
+# Pulp Motion: Framing-aware multimodal camera and human motion generation
+
+<a href="https://robincourant.github.io/info/"><strong>Robin Courant</strong></a>
+·
+<a href="https://davidlapous.github.io/"><strong>David Loiseaux</strong></a>
+·
+<a href="https://triocrossing.github.io/"><strong>Xi Wang</strong></a>
+·
+<a href="http://people.irisa.fr/Marc.Christie/"><strong>Marc Christie</strong></a>
+·
+<a href="https://vicky.kalogeiton.info/"><strong>Vicky Kalogeiton</strong></a>
+
+[![License](https://img.shields.io/badge/License-MIT-green.svg)]()
+
+</div>
+
+
+<div align="center">
+    <a href="https://www.lix.polytechnique.fr/vista/projects/2025_pulpmotion_courant/" class="button"><b>[Webpage]</b></a> &nbsp;&nbsp;&nbsp;&nbsp;
+    <a href="https://github.com/robincourant/pulp-motion" class="button"><b>[Code]</b></a> &nbsp;&nbsp;&nbsp;&nbsp;
+</div>
+
+<br/>
+
+![Teaser](./assets/teaser.png)
+
+---
+
+# Setup
+
+First, install `git lfs` by following the instructions [here](https://docs.github.com/en/repositories/working-with-files/managing-large-files/installing-git-large-file-storage).
+
+
+To get the data, run:
+```
+git clone https://huggingface.co/datasets/robin-courant/pulpmotion-models
+```
+
+
+Prepare the dataset (untar archives):
+```
+cd pulpmotion-models
+sh download_smpl
+```