diff --git a/README.md b/README.md
index f64bda1..58b51ad 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,30 @@
-# task-6a02e23da6fe2e4ac16acf65
+# Агент с RAG-памятью
 
+**Qdrant** + Ollama + LangChain.
+
+## Подготовка
+
+```bash
+ollama pull llama3
+ollama pull nomic-embed-text
+pip install -r requirements.txt
+```
+
+Данные Qdrant сохраняются локально в `./qdrant_data` (или `QDRANT_PATH` в окружении).
+
+## Инициализация базы из папки docs
+
+```bash
+python init_knowledge.py --dir ./docs
+```
+
+## Интерактивный клиент
+
+```bash
+python main.py
+```
+
+Команды:
+- `/search <запрос>` — прямой поиск в базе
+- `/add <заголовок> | <текст>` — добавить документ
+- `/quit` — выход