diff --git a/README.md b/README.md
new file mode 100644
index 0000000..61ab472
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# 🔍 Smart Search
+
+### Предварительные требования
+- Node.js версии 22.x или выше
+- npm (обычно устанавливается вместе с Node.js)
+
+### Установка и запуск
+
+1. **Клонируйте репозиторий**
+   ```bash
+   git clone https://github.com/PavelAxenov/smart-search.git
+   cd smart-search
+
+2. **Установка зависимостей**
+   ```bash
+   npm install
+
+3. **Запуск проекта в режиме разработки**
+   ```bash
+   npm run dev
\ No newline at end of file