Skip to content

Multi-AI Telegram Bot v0.1.0 (MVP)

Latest

Choose a tag to compare

@mrkorzun mrkorzun released this 28 Aug 11:21
· 3 commits to main since this release

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, openai client (через 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

Python
aiogram
OpenRouter
License: MIT