diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7cd7b6d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,93 @@
+<!-- ## ComfyUI-Animation_Nodes_and_Workflows
+These are ComfyUI custom nodes to assist in Animations and video compilations. -->
+
+## Join Videos
+
+The `Join Videos` node is for videos to video compilation. A node can take in up to 5 videos, and a combination of nodes can handle any number of videos with VRAM being the main limitation.
+
+<div align="center">
+
+<img src="readMeAssets/joinVids.gif" /> <br></br>
+<img src="readMeAssets/joinVideos2.gif" />
+</div>
+
+## Replace Img_or_Vid_Bg
+
+The `Replace Img_or_Vid_Bg` node is for replacing the background of images and videos. It is to be used with any background removal node.
+
+<div align="center">
+
+<img src="readMeAssets/replaceBg.gif" /> <br></br>
+</div>
+
+## Make Portrait Walk
+
+The `Make Portrait Walk` node receives a single portrait of a person and generates a batch of images that create the illusion of walking.
+
+<div align="center">
+
+<img src="readMeAssets/makeWalk.gif" /> <br></br>
+</div>
+
+## Move In_Or_Out
+
+The `Move In_Or_Out` node can be used to create the illusion of moving into or out of a place.
+
+<div align="center">
+
+<img src="readMeAssets/moveOut.gif" /> <br></br>
+</div>
+
+## Move Left_Or_Right
+
+The `Move Left_Or_Right` node can be used to animate a background image to move right or left so that the foreground image looks like it's moving left or right.
+
+<div align="center">
+
+<img src="readMeAssets/moveLeft.gif" /> <br></br>
+
+</div>
+
+## Move Up_Or_Down
+
+The `Move Up_Or_Down` node can be used to animate a background image to move down or up so that the foreground image looks like it's moving up or down.
+
+<div align="center">
+
+<img src="readMeAssets/moveUpDown.gif" /> <br></br>
+</div>
+
+## Video for LivePortrait
+
+The `Video for LivePortrait` node takes in a video of any size which contains a person and generates a 512x512 video of the person's face which can then be used as a driving video in Liveportrait (for face animation).
+
+<div align="center">
+
+<img src="livePortrait.gif" /> <br></br>
+</div>
+
+
+
+**<font color=red> Note </font>**:
+
+- >You can get these nodes by downloading this repository, extracting, and placing it in the custom_nodes folder of your ComfyUI directory. I will update this repository when the nodes become available through the ComfyUI-Manager.
+
+<!-- - >You can also connect a lineArt preprocessor to the LineArt2LineArt Assistant node and modify as you please.
+
+- >You can install these nodes with the ComfyUI Manager. Search by entering:
+
+
+     ```
+     ComfyUI-Img2DrawingAssistants
+
+     ``` -->
+
+
+
+## Disclaimer
+ 
+I am not responsible for any user-generated content. Users are fully responsible for their actions when using these nodes and workflows. I don't have any legal affiliation with or accountability for users' behaviors. It is crucial to use these nodes and workflows responsibly, following both ethical and legal standards.
+
+
+
+
diff --git a/readMeAssets/joinVideos2.gif b/readMeAssets/joinVideos2.gif
new file mode 100644
index 0000000..1c0a9f0
Binary files /dev/null and b/readMeAssets/joinVideos2.gif differ
diff --git a/readMeAssets/joinVids.gif b/readMeAssets/joinVids.gif
new file mode 100644
index 0000000..1d5d9d4
Binary files /dev/null and b/readMeAssets/joinVids.gif differ
diff --git a/readMeAssets/livePortrait.gif b/readMeAssets/livePortrait.gif
new file mode 100644
index 0000000..2e3eaf0
Binary files /dev/null and b/readMeAssets/livePortrait.gif differ
diff --git a/readMeAssets/makeWalk.gif b/readMeAssets/makeWalk.gif
new file mode 100644
index 0000000..ed5feee
Binary files /dev/null and b/readMeAssets/makeWalk.gif differ
diff --git a/readMeAssets/moveLeft.gif b/readMeAssets/moveLeft.gif
new file mode 100644
index 0000000..c46b466
Binary files /dev/null and b/readMeAssets/moveLeft.gif differ
diff --git a/readMeAssets/moveOut.gif b/readMeAssets/moveOut.gif
new file mode 100644
index 0000000..456ad5b
Binary files /dev/null and b/readMeAssets/moveOut.gif differ
diff --git a/readMeAssets/moveUpDown.gif b/readMeAssets/moveUpDown.gif
new file mode 100644
index 0000000..29bc6e2
Binary files /dev/null and b/readMeAssets/moveUpDown.gif differ
diff --git a/readMeAssets/replaceBg.gif b/readMeAssets/replaceBg.gif
new file mode 100644
index 0000000..94316b0
Binary files /dev/null and b/readMeAssets/replaceBg.gif differ