pollinations-simple 1.0.0

Легкая Python библиотека для работы с Pollinations AI

🌸 Pollinations AI - Python библиотека

Простая и удобная библиотека для работы с текстовыми моделями Pollinations AI.

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

• 🚀 Простой запрос одной функцией ask()
• 💬 Чат с историей сообщений
• 🔄 Стриминг ответов в реальном времени
• 🎯 Поддержка разных моделей (Gemini, Mistral, OpenAI)
• 📝 JSON режим для структурированных ответов
• 🆓 Бесплатно без API ключа

📦 Установка

# Зависимость только requests
pip install requests

Скопируйте папку pollinations/ в ваш проект.

🚀 Быстрый старт

Самый простой способ

from pollinations import ask

answer = ask("Что такое Python?")
print(answer)

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

from pollinations import PollinationsClient

client = PollinationsClient(
    model="gemini",  # модель по умолчанию
    system_prompt="Отвечай кратко"
)

response = client.ask("Объясни рекурсию")
print(response)

Чат с историей

from pollinations import PollinationsClient, Message

client = PollinationsClient()

messages = [
    Message("system", "Ты полезный ассистент"),
    Message("user", "Меня зовут Никита"),
    Message("assistant", "Привет, Никита!"),
    Message("user", "Как меня зовут?"),
]

response = client.chat(messages)
print(response.content)  # "Тебя зовут Никита"

Стриминг

from pollinations import PollinationsClient

client = PollinationsClient()

for chunk in client.stream("Напиши историю"):
    print(chunk, end="", flush=True)

JSON режим

from pollinations import ask

data = ask(
    "Верни JSON с полями: name, age, city",
    json_mode=True
)
print(data)  # {"name": "...", "age": 25, "city": "..."}

🔧 API

PollinationsClient

client = PollinationsClient(
    api_key=None,          # Опционально, для повышенных лимитов
    model="openai",        # Модель по умолчанию
    system_prompt=None,    # Системный промпт по умолчанию
    timeout=60,            # Таймаут в секундах
)

Методы

Метод	Описание
ask(prompt)	Простой запрос → строка
chat(messages)	Чат с историей → ChatResponse
stream(prompt)	Стриминг → итератор
quick(prompt)	Быстрый GET запрос → строка
get_models()	Список моделей → List[Model]

Message

from pollinations import Message

msg = Message(
    role="user",     # "user", "assistant", "system"
    content="Текст"
)

Также можно использовать обычные словари:

messages = [
    {"role": "system", "content": "..."},
    {"role": "user", "content": "..."}
]

ChatResponse

response = client.chat(messages)

response.content       # Текст ответа
response.text          # Алиас для content
response.model         # Использованная модель
response.finish_reason # Причина завершения
response.usage         # Статистика токенов
response.raw_response  # Полный ответ API

🤖 Доступные модели

Модель	Описание	Особенности
openai	GPT-OSS 20B	Reasoning
gemini	Gemini 2.5 Flash	Vision
mistral	Mistral 3.2 24B	Tools

Получить актуальный список:

client = PollinationsClient()
for model in client.get_models():
    print(f"{model.name}: {model.description}")

📝 Примеры

Смотрите файл examples.py для полных примеров.

📄 Лицензия

MIT