Improve model card with metadata and links

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +45 -3
README.md CHANGED
@@ -1,3 +1,45 @@
1
- ---
2
- license: apache-2.0
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ pipeline_tag: depth-estimation
4
+ library_name: diffusers
5
+ ---
6
+
7
+ # NormalCrafter: Learning Temporally Consistent Normals from Video Diffusion Priors
8
+
9
+ [NormalCrafter](https://normalcrafter.github.io/) generates temporally consistent normal sequences with fine-grained details from open-world videos of arbitrary lengths. This model is based on the paper [NormalCrafter: Learning Temporally Consistent Normals from Video Diffusion Priors](https://huggingface.co/papers/2504.11427).
10
+
11
+
12
+ ## ๐Ÿš€ Quick Start
13
+
14
+ ### ๐Ÿค– Gradio Demo
15
+ - Online demo: [NormalCrafter](https://huggingface.co/spaces/Yanrui95/NormalCrafter)
16
+ - Local demo:
17
+ ```bash
18
+ gradio app.py
19
+ ```
20
+
21
+ ### ๐Ÿ› ๏ธ Installation
22
+ 1. Clone this repo:
23
+ ```bash
24
+ git clone git@github.com:Binyr/NormalCrafter.git
25
+ ```
26
+ 2. Install dependencies (please refer to [requirements.txt](requirements.txt)):
27
+ ```bash
28
+ pip install -r requirements.txt
29
+ ```
30
+
31
+
32
+
33
+ ### ๐Ÿค— Model Zoo
34
+ [NormalCrafter](https://huggingface.co/Yanrui95/NormalCrafter) is available in the Hugging Face Model Hub.
35
+
36
+ ### ๐Ÿƒโ€โ™‚๏ธ Inference
37
+ #### 1. High-resolution inference, requires a GPU with ~20GB memory for 1024x576 resolution:
38
+ ```bash
39
+ python run.py --video-path examples/example_01.mp4
40
+ ```
41
+
42
+ #### 2. Low-resolution inference requires a GPU with ~6GB memory for 512x256 resolution:
43
+ ```bash
44
+ python run.py --video-path examples/example_01.mp4 --max-res 512
45
+ ```