Любин AI-агент - @liubas_helper_bot
📋 Статус проекта
Исполнен. Реализован. Возможны дальнейшие улучшения и интеграции.
Liuba's Agent AI — лёгкий Telegram-бот-помощник с базовыми командами и примерами интеграции с внешними сервисами через бесплатные API. Создан как тестовое задание, но полностью рабочий и доступен для использования: https://t.me/liubas_helper_bot . Бот предоставляет быстрый доступ к полезной информации: погода, Википедия, GitHub и даже локальный семантический поиск по базе знаний.
Точка входа — src/main.py; логика бота реализована в src/telegram_bot.py, а внешние модули находятся в src/mcp/.
🧩 Основные возможности
- /help — краткая справка
- /health — проверка состояния системы и API
- /weather <город> — текущая температура (Open-Meteo API)
- /wiki <тема> — краткое описание из Википедии
- /github <запрос> — поиск репозиториев на GitHub
- /search <запрос> — семантический поиск по локальной базе знаний
- /chat <текст> — свободный диалог с ИИ (OpenRouter)
- /context 10 — показать последние 10 сообщений диалога
- /forget — очистить историю пользователя
🪄 MCP-интеграции
| Модуль | Описание | API |
|---|---|---|
| Weather | Получение текущей температуры и координат по городу | Open-Meteo API |
| Wikipedia | Краткие описания тем | Wikipedia REST API |
| GitHub | Поиск публичных репозиториев | GitHub REST API v3 |
| Knowledge Base | Семантический поиск по локальной базе фактов | ChromaDB + SentenceTransformers |
| Chat | Свободный диалог с ИИ | OpenRouter API |
🛠️ Используемые технологии
Язык: Python 3.10+
Фреймворк: python-telegram-bot (v20+)
Интеграции: Open-Meteo, Wikipedia, GitHub, OpenRouter
База знаний: ChromaDB + SentenceTransformers
Окружение: dotenv
📦 Архитектура
src/main.py— точка входаsrc/telegram_bot.py— регистрация команд и запуск pollingsrc/mcp/— модули интеграций (погода, wiki, github и др.)src/knowledge_base.py— логика семантического поиска- Память хранится в
memory.json(команды: /context, /forget)
🚀 Установка и запуск
git clone <repo-url>
cd agent-liuba
python -m venv .venv
. .venv/Scripts/activate # Windows PowerShell: . .venv/Scripts/Activate.ps1
pip install -r requirements.txt
python src/main.py
⚙️ Переменные окружения
TELEGRAM_TOKEN=<токен_вашего_бота>
WIKI_USER_AGENT=PomoshnikLiubyBot/1.0 (docs-example)
OPENROUTER_API_KEY=<ваш_openrouter_api_key>
OPENROUTER_MODEL=openrouter/auto
🐳 Docker
# Сборка
docker build -t agent-liuba .