81 lines
No EOL
2.2 KiB
Markdown
81 lines
No EOL
2.2 KiB
Markdown
# Matrix Image Recognition Bot
|
||
|
||
Бот для Matrix, который распознаёт изображения с помощью Qwen-VL.
|
||
|
||
## Описание
|
||
|
||
Этот бот подключается к Matrix серверу, слушает изображения в разрешённых комнатах и отправляет их в Qwen-VL API для анализа. Бот возвращает описание изображения обратно в чат.
|
||
|
||
## Требования
|
||
|
||
- Python 3.10+
|
||
- Доступ к Matrix серверу
|
||
- API ключ Qwen-VL
|
||
|
||
## Установка
|
||
|
||
1. Клонируйте репозиторий:
|
||
```bash
|
||
git clone <repository-url>
|
||
cd b2b_assistants
|
||
```
|
||
|
||
2. Создайте виртуальное окружение:
|
||
```bash
|
||
python -m venv venv
|
||
source venv/bin/activate # Linux/Mac
|
||
# или
|
||
venv\Scripts\activate # Windows
|
||
```
|
||
|
||
3. Установите зависимости:
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
4. Настройте переменные окружения в файле `.env`:
|
||
|
||
```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
|
||
```
|
||
|
||
## Запуск
|
||
|
||
```bash
|
||
python src/image_bot.py
|
||
```
|
||
|
||
## Команды бота
|
||
|
||
- `/help` - показать справку по командам
|
||
- `/status` - показать статус бота
|
||
|
||
## Использование
|
||
|
||
1. Пригласите бота в комнату Matrix
|
||
2. Отправьте изображение в чат
|
||
3. Бот автоматически проанализирует изображение и вернёт описание
|
||
|
||
## Структура проекта
|
||
|
||
```
|
||
b2b_assistants/
|
||
├── .env # Переменные окружения
|
||
├── requirements.txt # Зависимости Python
|
||
├── README.md # Документация
|
||
└── src/
|
||
└── image_bot.py # Основной код бота
|
||
```
|
||
|
||
## Лицензия
|
||
|
||
MIT |