62 lines
2.1 KiB
Markdown
62 lines
2.1 KiB
Markdown
# Валера - ИИ-ассистент 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 (опционально)
|