← Blog

Python onipin SDK: chat, catalog, and bookings from agents

Official PyPI client. pip install onipin — handshake, chat, poll messages, bookings, and orders with the business pin. Ideal for LangChain and scripts.

The onipin package on PyPI is the official Python SDK for the OniPin protocol (onipin/0.2).

Installation

pip install onipin

Quick example

from onipin import OniPinClient

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

oni.handshake("business.chat")
chat = oni.chat("Hi, what services do you offer?", intent="business.chat")
print(chat.get("reply"))

Available API

MethodDescription
ping()Business discovery
handshake(intent)OniPin 0.2 handshake
catalog()Products and services
chat(message, intent=…)Send a message
messages(...) / poll_messages(...)Read thread / wait for bot
create_booking(...) / create_order(...)Real booking or order

No mandatory API key

You only need the public pin. Agent auth ona_… is optional (higher quota).

Ecosystem

SDK documentation → · PyPI →