Matrix Image Recognition Bot

Бот для Matrix, который распознаёт изображения с помощью Qwen-VL.

Описание

Этот бот подключается к Matrix серверу, слушает изображения в разрешённых комнатах и отправляет их в Qwen-VL API для анализа. Бот возвращает описание изображения обратно в чат.

Требования

• Python 3.10+
• Доступ к Matrix серверу
• API ключ Qwen-VL

Установка

1. Клонируйте репозиторий:

git clone <repository-url>
cd b2b_assistants

2. Создайте виртуальное окружение:

python -m venv venv
source venv/bin/activate  # Linux/Mac
# или
venv\Scripts\activate  # Windows

3. Установите зависимости:

pip install -r requirements.txt

4. Настройте переменные окружения в файле .env:

# Matrix подключение
HOMESERVER=https://matrix.lambda.coredump.ru
MATRIX_USERNAME=@image_bot:matrix.lambda.coredump.ru
PASSWORD=ваш_пароль_бота
ALLOWED_ROOMS=!QcPkdLDWqDegdtDnpP:matrix.lambda.coredump.ru

# Qwen API
QWEN_API_KEY=sk-L6oRP0m15Z9YquluktS6w
QWEN_ENDPOINT=https://llm.lambda.coredump.ru/v1
QWEN_VL_MODEL=qwen-vl-plus

Запуск

python src/image_bot.py

Команды бота

• /help - показать справку по командам
• /status - показать статус бота

Использование

1. Пригласите бота в комнату Matrix
2. Отправьте изображение в чат
3. Бот автоматически проанализирует изображение и вернёт описание

Структура проекта

b2b_assistants/
├── .env                 # Переменные окружения
├── requirements.txt     # Зависимости Python
├── README.md           # Документация
└── src/
    └── image_bot.py    # Основной код бота

Лицензия

MIT