← Blog

SDK Python onipin: chat, catálogo y reservas desde agents

Cliente oficial en PyPI. pip install onipin — handshake, chat, poll messages, bookings y orders con el pin del negocio. Ideal para LangChain y scripts.

El paquete onipin en PyPI es el SDK oficial de Python para el protocolo OniPin (onipin/0.2).

Instalación

pip install onipin

Ejemplo rápido

from onipin import OniPinClient

oni = OniPinClient(
    pin="onp_tu_pin",
    base_url="https://onnivers.store",
    agent={"name": "MiAgente", "version": "1.0"},
)

oni.handshake("business.chat")
chat = oni.chat("Hola, ¿qué servicios ofrecen?", intent="business.chat")
print(chat.get("reply"))

API disponible

MétodoDescripción
ping()Discovery del negocio
handshake(intent)Handshake OniPin 0.2
catalog()Productos y servicios
chat(message, intent=…)Enviar mensaje
messages(...) / poll_messages(...)Leer hilo / esperar bot
create_booking(...) / create_order(...)Reserva o pedido real

Sin API key obligatoria

Solo necesitas el pin público. Auth de agente ona_… es opcional (más cuota).

Ecosistema

Documentación SDK → · PyPI →