Add README and MIT LICENSE

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Yanrui Bin, Wenbo Hu, Haoyuan Wang, Xinya Chen, Bing Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,3 +1,49 @@
----
-license: apache-2.0
----
+# NormalCrafter — Video Normal Map Estimation
+
+Mirror of [Yanrui95/NormalCrafter](https://huggingface.co/Yanrui95/NormalCrafter) hosted by [AEmotionStudio](https://huggingface.co/AEmotionStudio) for use with [ComfyUI-FFMPEGA](https://github.com/AEmotionStudio/ComfyUI-FFMPEGA).
+
+## Model Description
+
+NormalCrafter generates **temporally consistent surface normal maps** from video using a Stable Video Diffusion (SVD) backbone fine-tuned for normal estimation. Unlike image-based methods (e.g., Marigold), NormalCrafter operates natively on video sequences, producing smooth frame-to-frame normals without flickering.
+
+## Key Features
+
+- **Video-native**: Processes temporal sequences for coherent normals across frames
+- **SVD backbone**: Built on `stabilityai/stable-video-diffusion-img2vid-xt`
+- **High resolution**: Supports up to 1024px inference
+- **MIT Licensed**: Free for commercial and personal use
+
+## Model Files
+
+| File | Size | Description |
+|------|------|-------------|
+| `unet/diffusion_pytorch_model.safetensors` | 3.05 GB | Fine-tuned UNet for normal estimation |
+| `image_encoder/model.fp16.safetensors` | 1.26 GB | CLIP image encoder (fp16) |
+| `vae/diffusion_pytorch_model.safetensors` | 196 MB | VAE decoder |
+
+## Usage in ComfyUI-FFMPEGA
+
+NormalCrafter is available as:
+- **Standalone skill**: `normalcrafter` in the FFMPEGA agent
+- **No-LLM mode**: Select `normalcrafter` in the agent node dropdown
+- **AI Relighting**: Enable "Use NormalCrafter" in the Video Editor's Relight panel for physically-based relighting
+
+## Citation
+
+```bibtex
+@article{normalcrafter2024,
+  title={NormalCrafter: Learning Temporally Consistent Normals from Video Diffusion Priors},
+  author={Yanrui Bin and Wenbo Hu and Haoyuan Wang and Xinya Chen and Bing Wang},
+  year={2024}
+}
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Links
+
+- **Paper**: [NormalCrafter](https://github.com/Binyr/NormalCrafter)
+- **Upstream weights**: [Yanrui95/NormalCrafter](https://huggingface.co/Yanrui95/NormalCrafter)
+- **ComfyUI-FFMPEGA**: [AEmotionStudio/ComfyUI-FFMPEGA](https://github.com/AEmotionStudio/ComfyUI-FFMPEGA)