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

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

Method	Description
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

• Node: onipin-js
• React: onipin-react
• OpenAPI: https://onnivers.store/v1/openapi.yaml

SDK documentation → · PyPI →