From 6ce048d4adf0aedadb938abb43f15b3f9b5726a9 Mon Sep 17 00:00:00 2001
From: Sergey Penkovsky <penkovsky_sa@st.by>
Date: Wed, 23 Jul 2025 14:45:39 +0300
Subject: [PATCH] doc: update readme

---
 README.md | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 092f20d..2e7081d 100644
--- a/README.md
+++ b/README.md
@@ -7,19 +7,40 @@
 
 ---
 
-## 🚀 Установка
+## Установка
+
+Рекомендуется использовать виртуальное окружение (venv) для изоляции зависимостей и корректной работы импортов.
 
-### Через pip (локально)
 ```bash
+python3 -m venv venv
+source venv/bin/activate
 pip install .
 ```
 
-### Через pip (с PyPI)
+Также вы можете вручную установить необходимые зависимости:
+
+```bash
+pip install torch numpy dill
+```
+
+Если появится файл `requirements.txt`, используйте:
+
+```bash
+pip install -r requirements.txt
+```
+
+Если вы хотите использовать последнюю версию из PyPI:
+
 ```bash
 pip install simple-llm
 ```
 
-После установки вы сможете запускать примеры и использовать модули из любого места.
+Если возникают ошибки с импортами, убедитесь, что пакет установлен через pip и вы находитесь в активированном виртуальном окружении.
+
+### Основные зависимости
+- torch
+- numpy
+- dill
 
 **Краткая инструкция по обучению на своих данных:**
 1. Обучите BPE-токенизатор на тексте (см. `simple_llm.tokenizer.bpe.BPE`).