diff --git a/README.md b/README.md
index abf18fc..5d85247 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,45 @@
-# Sorting-Algorithms-Visualization-Python
+# Sorting Algorithms Visualization Python
+
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.7%2B-blue.svg)](https://www.python.org)
+[![Pygame](https://img.shields.io/badge/Pygame-2.0.1-blue.svg)](https://www.pygame.org)
+
+A visualization tool for various sorting algorithms implemented in Python. See how different sorting algorithms work and how they perform on different datasets.
+
+Sorting Algorithms Visualization Python Demo: demo.gif
+
+## Features
+
+- Visualize popular sorting algorithms, including Bubble Sort, Selection Sort, Insertion Sort, Merge Sort, Quick Sort, and more.
+- Choose from various pre-defined datasets, including random, sorted, reversed, and nearly sorted data.
+- Adjust the speed of the visualization to observe the sorting process in real-time or faster.
+- Step through the sorting process one step at a time or let it run continuously.
+- Pause, resume, and reset the visualization as needed.
+- Interactive user interface to control the visualization.
+
+## Prerequisites
+
+- Python 3.7 or higher
+- Pygame library (https://www.pygame.org)
+
+## Getting Started:
+
+1. Clone this repository to your local machine.
+2. Install the required dependencies by running the following command:
+   `pip install pygame`
+3. Run the program by executing the following command:
+   `python main.py`
+4. Use the user interface to select a sorting algorithm, dataset, and adjust the visualization settings.
+5. Start the visualization and observe the sorting algorithm in action.
+
+## Screenshots:
+
+Screenshot 1: screenshot1.png
+Screenshot 2: screenshot2.png
+
+## Authors:
+
+- Nazir (@nazir20)
+- Judy (@judy-nkwama)
+- Asli (@asliBozkurt)
+