Metadata-Version: 2.4
Name: max-yandexgpt
Version: 0.1.0
Summary: Python framework for building Max messenger bots powered by YandexGPT
Author-email: Nikolai Nabiev <niko-rech@yandex.ru>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nabinabi11/max-yandexgpt
Project-URL: Repository, https://github.com/nabinabi11/max-yandexgpt
Project-URL: Repository (GitVerse), https://gitverse.ru/nikolainabiev/max-yandexgpt
Project-URL: Issues, https://github.com/nabinabi11/max-yandexgpt/issues
Keywords: max,messenger,yandexgpt,bot,ai,chatbot
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: maxapi>=0.1.0
Requires-Dist: openai>=1.0.0
Dynamic: license-file

# max-yandexgpt

Python-фреймворк для создания ботов в Max мессенджере с YandexGPT.

5 строк кода — и у вас работающий AI-бот со стримингом ответов.

## Быстрый старт

```bash
pip install max-yandexgpt
```

```python
from max_yandexgpt import MaxYandexGPT

bot = MaxYandexGPT(
    max_token="ВАШ_ТОКЕН_MAX",
    yandex_api_key="ВАШ_КЛЮЧ_YANDEXGPT",
    yandex_folder_id="ВАШ_FOLDER_ID",
)
bot.run()
```

## Возможности

- **Стриминг ответов** — бот отправляет placeholder, затем обновляет сообщение по мере генерации текста YandexGPT
- **Обычный режим** — простой запрос-ответ, одно сообщение
- **Выбор модели** — поддержка всех моделей YandexGPT
- **Настройка** — system prompt, температура, max_tokens
- **Переменные окружения** — задайте `MAX_TOKEN`, `YANDEX_API_KEY`, `YANDEX_FOLDER_ID` вместо хардкода

## Модели

| Модель | Описание |
|--------|----------|
| `yandexgpt-5-lite/latest` | Быстрая и дешёвая (по умолчанию) |
| `yandexgpt-5-pro/latest` | Стандартная |
| `yandexgpt-5.1/latest` | Новейшая |
| `aliceai-llm/latest` | AliceAI |

```python
bot = MaxYandexGPT(
    max_token="...",
    yandex_api_key="...",
    yandex_folder_id="...",
    model="yandexgpt-5.1/latest",
)
```

## Настройка

```python
bot = MaxYandexGPT(
    max_token="...",
    yandex_api_key="...",
    yandex_folder_id="...",
    system_prompt="Ты — полезный ассистент.",
    stream=True,           # стриминг включён по умолчанию
    temperature=0.3,
    max_tokens=2000,
)
```

Или через переменные окружения:

```python
bot = MaxYandexGPT()  # читает из MAX_TOKEN, YANDEX_API_KEY, YANDEX_FOLDER_ID
bot.run()
```

## Требования

- Python 3.11+
- Токен бота Max мессенджера ([создать бота](https://max.ru))
- API-ключ YandexGPT + folder ID ([Yandex Cloud](https://cloud.yandex.ru))

## Лицензия

MIT
