diff --git a/README.md b/README.md
index f56ac66..a9e9780 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,32 @@
-# ComfyUI-Color-Palette
\ No newline at end of file
+# ComfyUI-Color-Palette
+
+A custom node for ComfyUI that extracts the main color palette from an uploaded image and calculates the percentage of each color.
+
+## Installation
+
+1. Navigate to your ComfyUI `custom_nodes` directory:
+   ```bash
+   cd ComfyUI/custom_nodes/
+   ```
+
+2. Clone this repository (or create a new folder `ComfyUI-Color-Palette` and copy the files into it):
+   ```bash
+   git clone <your-github-repo-url> ComfyUI-Color-Palette
+   cd ComfyUI-Color-Palette
+   ```
+
+3. Install the required dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+4. Restart ComfyUI.
+
+## Features
+- Extracts the top N dominant colors from an image using K-Means clustering.
+- Generates a visual color palette image.
+- Outputs detailed hex codes and percentage distributions as text.
+
+## Usage
+Find the node in the ComfyUI menu under: **image -> analysis -> 🎨 Image Color Palette Analyzer**.
+Connect an image input, set the number of colors you want to extract, and view the output image and text data.