Telegram AI Bot Project

Минимальный рабочий проект Telegram-бота с подключением LLM API через OpenAI-совместимый интерфейс.

1) Подготовка

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

2) Конфигурация

1. Скопируйте .env.example в .env
2. Заполните переменные:
   • BOT_TOKEN — токен от @BotFather
   • LLM_API_KEY — ключ Mistral или access token GigaChat (после OAuth)
   • LLM_BASE_URL — базовый URL API
   • LLM_MODEL — модель
   • LLM_SYSTEM_PROMPT — системный промпт

Примеры LLM_BASE_URL (формат chat completions, как в уроке):

• Mistral: https://api.mistral.ai/v1
• GigaChat: https://gigachat.devices.sberbank.ru/api/v1 (в LLM_API_KEY подставляйте access token после OAuth; ключ авторизации не кладите в поле Bearer напрямую)

Получение access token для GigaChat: https://developers.sber.ru/docs/ru/gigachat/api/authorization

3) Запуск

python -m bot.main

4) Проверка

• Напишите боту /start
• Отправьте произвольный текст
• Убедитесь, что бот отвечает через LLM API

5) Частые проблемы

• RuntimeError: Missing required environment variable -> проверьте .env
• Unauthorized -> неправильный токен/ключ
• Бот не отвечает -> процесс не запущен или неверный BOT_TOKEN