diff --git a/README.md b/README.md
index eecec60..2fc1653 100644
--- a/README.md
+++ b/README.md
@@ -4,13 +4,36 @@ https://github.com/gyanantaran/searchViz/assets/95016059/8a3eab8e-1456-48a5-a91c
 
 <img width="709" alt="Screenshot 2024-04-09 at 12 57 55 AM" src="https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1">
 
+## Contributions
 
-## A Nice Demo Video
+All contributions/suggestions are welcome!
+
+## Introduction
+
+Search methods are boring and fruitless untill they are visualised. Depth first search feels like a random walker on a lonely island. Breadth first search is like a stow but steady fire burning through a dense forestry. Don't believe me? See for your selves! Also, feel free to try writing your very own search methods, with the current API (not documented, only examples available inside searchViz/src/searchViz/Search.py::DFS and BFS).
+
+## Instructions to build the project
+
+```sh
+cd searchViz                     # cd into the cloned directory
+pip install -r requirements.txt  # basically installs numpy and pygame
+python src/main.py               # run the entry-point file
+
+# now just press spacebar to play or pause the search for the current search-method. DFS is the default.
+```
+
+## Some Demo examples
+
+A nice and long, demo video:
 
 [![A long Walkthrough Video -- searchViz](https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1)](https://youtu.be/BKF-PEgd1PA?t=393)
 
 <!-- https://user-images.githubusercontent.com/95016059/273106123-19ccd387-f563-4078-825d-e62327bfdde7.mp4 -->
 
+A short Walkthrough:
+
+[![Short Walkthrough Video -- searchViz](https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1)](https://youtu.be/kNGsOoWh9fM?t=2)
+
 ## Features
 
 1. Nodes distributions can be one of a few options (gaussian, unifrom)
@@ -20,10 +43,4 @@ https://github.com/gyanantaran/searchViz/assets/95016059/8a3eab8e-1456-48a5-a91c
 
 1. Using vectorized functions in numpy
 
-Contributions and feedbacks are welcome! 
-
-## A short Walkthrough
-
-[![Short Walkthrough Video -- searchViz](https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1)](https://youtu.be/kNGsOoWh9fM?t=2)
-
-@vishalpaudel
+creative commons License, copyright, gyanantaran aka vishalpaudel 2022.
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..3c438c1
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,4 @@
+numpy==2.0.0
+pygame==2.5.2
+setuptools==70.0.0
+wheel==0.43.0