From 66fd5a2ca8108b6a653139082b3f17628a2d87bf Mon Sep 17 00:00:00 2001
From: mirivlad <mirivlad@mirv.top>
Date: Tue, 17 Mar 2026 03:32:40 +0800
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=20README=20=D1=81=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83?=
 =?UTF-8?q?=D0=BA=D1=86=D0=B8=D0=B5=D0=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c7fcabb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,61 @@
+# Валера - ИИ-ассистент Telegram-бот
+
+Интеллектуальный Telegram-бот с поддержкой нескольких LLM, памятью на ChromaDB, распознаванием речи и планировщиком задач.
+
+## Возможности
+
+- **Интеграция с LLM**: qwen-code, opencode, Gigachat, YandexGPT
+- **Память**: Векторная БД ChromaDB для хранения истории разговоров
+- **Режимы работы**: С подтверждением и автономный
+- **Распознавание речи**: Vosk или Faster-Whisper
+- **Планировщик**: Напоминания и периодическая генерация идей
+- **Прокси**: Поддержка SOCKS5 и MTProxy
+
+## Установка
+
+1. Клонируйте репозиторий и перейдите в директорию:
+```bash
+cd valera
+```
+
+2. Установите зависимости:
+```bash
+pip install -r requirements.txt
+```
+
+3. Скопируйте `.env.example` в `.env` и заполните настройки:
+```bash
+cp .env.example .env
+```
+
+4. Настройте переменные окружения в `.env`:
+```env
+TELEGRAM_BOT_TOKEN=your_bot_token
+TELEGRAM_PROXY_URL=  # опционально
+DEFAULT_TOOL=opencode
+```
+
+## Запуск
+
+```bash
+python -m src.bot.main
+```
+
+## Команды
+
+- `/start` - Начать работу
+- `/help` - Показать справку
+- `/mode confirm|auto` - Переключить режим
+- `/use qwen|open|gigachat|yandex` - Выбрать LLM
+- `/qwen|/open|/gigachat|/yandex <текст>` - Задать вопрос
+- `/forget` - Очистить историю
+- `/remind <текст> <время>` - Создать напоминание
+- `/stt on|off` - Включить/выключить распознавание речи
+- `/cancel` - Отменить текущее действие
+
+## Требования
+
+- Python 3.10+
+- qwen-code и/или opencode в PATH
+- ffmpeg (для аудио)
+- Модель Vosk или Faster-Whisper (опционально)