diff --git a/README.md b/README.md
index 73e3e73..0f00449 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,31 @@
-# task-6a1864f78a94f887e50d46da
+# Экзамен: RAG-агент с ChromaDB и веб-поиском
 
-Экзамен: RAG-агент с ChromaDB и веб-поиском
\ No newline at end of file
+Локальный RAG (ChromaDB + Ollama embeddings) и веб-поиск (Tavily). Агент выбирает источник.
+
+## Требования
+
+```bash
+ollama pull llama3
+ollama pull nomic-embed-text
+```
+
+В `.env`:
+
+```env
+TAVILY_API_KEY=your_key
+```
+
+## Установка и запуск
+
+```bash
+pip install -r requirements.txt
+python main.py --init      # загрузить documents/ в ChromaDB
+python main.py --demo      # два примера (local + web)
+python main.py             # интерактивный чат (exit для выхода)
+```
+
+## Структура
+
+- `vectorstore.py` — Chroma + загрузка документов с чанкингом
+- `main.py` — инструменты `search_local_kb`, `web_search`, `create_agent`
+- `documents/` — тестовые конспекты