diff --git a/README.md b/README.md
new file mode 100644
index 0000000..654f6c5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,51 @@
+## Инструкция по установке и запуску
+
+### 1. Установка `deep-agents-from-scratch`
+
+```bash
+# Clone the repository
+git clone https://github.com/langchain-ai/deep-agents-from-scratch.git
+cd deep-agents-from-scratch
+
+# Install with uv (recommended)
+uv sync
+
+# Or install with pip
+pip install -e .
+```
+
+### 2. Установка вашего агента
+
+```bash
+# Create your project directory
+mkdir my_deep_agent
+cd my_deep_agent
+
+# Create the file structure as shown above
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+### 3. Запуск Ollama
+
+```bash
+# Pull the model
+ollama pull llama3.2
+
+# Start Ollama (if not running)
+ollama serve
+```
+
+### 4. Запуск агента
+
+```bash
+# Run with default task
+python -m deep_agent.run
+
+# Run with custom task
+python -m deep_agent.run "Find latest news about AI and save to ai_news.md"
+
+# Specify export directory
+python -m deep_agent.run --export-dir ./my_results "Research quantum computing"
+```
\ No newline at end of file