Python SDK

important

The botconnector-ai package is not published to PyPI. The dependency-free source SDK is implemented and live-tested; copy it from the accepted source tree or use the OpenAI-compatible API with any Python OpenAI client.

What is it?

A thin Python client for BotConnector Core, the same service used by the desktop app and CLI. The SDK calls Core’s local API; model loading, runtimes and serving stay inside Core.

Source usage (preview)

bash

pip install botconnector-ai

The package is source-only for now; do not use pip install botconnector-ai because no PyPI release exists.

Target design

python

from botconnector import Client

client = Client()

models = client.models.list()
model = client.llm("qwen/model")
response = model.chat("Hello")
print(response.text)

In this section

Use today

The local API is OpenAI-compatible, so the standard OpenAI client works:

python

from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:11435/v1", api_key="not-needed")
resp = client.chat.completions.create(
    model="<publisher>/<model>",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

See OpenAI-compatible API for the endpoint reference.

Status

Tracked as Experimental / Implemented / Preview on the status page. PyPI publication is not available yet.