Repository navigation
Release notes (EN)
## 🎉 What’s new (v0.1.0 — MVP)
First public release of a **multi-model Telegram bot** on **aiogram v3** with model picker via **OpenRouter**.
### ✨ Features
- Model selector at start: **Llama**, **DeepSeek**, **Claude**, **Grok** (extensible).
- Per-model greeting/intro messages.
- Clean FSM: `choosing_model → waiting_prompt → generating`.
- Async processing and anti-flood during generation.
- Safe HTML rendering of Markdown + long message splitting.
- Navigation: **Back to Models** button, **/start**, **/models**, **/cancel**.
### 🧱 Stack
Python 3.11+, aiogram v3, OpenRouter (via `openai` client), python-dotenv.
### 🚀 Quick start
```bash
python -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # set TG_TOKEN and AI_TOKEN
python main.py
🎉 Что нового (v0.1.0 — MVP)
Первая публичная версия мульти-модельного Telegram-бота на aiogram v3 с выбором ИИ-модели через OpenRouter.
Основные возможности
- Выбор модели при старте: Llama, DeepSeek, Claude, Grok (архитектура расширяемая).
- Отдельные приветствия/самопрезентации для каждой модели.
- Чистая FSM-логика:
choosing_model → waiting_prompt → generating. - Асинхронная обработка и защита от флуда во время генерации.
- HTML-рендер Markdown-ответов + безопасное разбиение длинных сообщений.
- Навигация: кнопка Back to Models, команды /start, /models, /cancel.
Технологии
- Python 3.11+, aiogram v3,
openaiclient (через OpenRouter API),python-dotenv.
Быстрый старт
python -m venv .venv && . .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env # заполните TG_TOKEN и AI_TOKEN
python main.pyПеременные окружения
TG_TOKEN — токен Telegram-бота
AI_TOKEN — ключ OpenRouterНеобязательные переопределения моделей: LLAMA_MODEL, DEEPSEEK_MODEL, ANTHROPIC_MODEL, XAI_MODEL
Известные моменты
Контекст диалога хранится в памяти процесса (для продакшена лучше RedisStorage).
Возможны таймауты внешних моделей — рекомендуется выставлять asyncio.wait_for и ретраи.
Дальше в планах
RedisStorage для FSM
Режимы (creative / code / translate)
История контекста по модели
CI (ruff/lint) + Dockerfile и деплой на Render/Heroku