Bee SDKs

npm install @cuilabs/bee
# or pnpm add @cuilabs/bee
# or yarn add @cuilabs/bee

Quickstart

import { BeeClient } from "@cuilabs/bee";

const bee = new BeeClient({ apiKey: process.env.BEE_API_KEY! });

const out = await bee.chat.completions.create({
  model: "bee-cell",
  messages: [
    { role: "user", content: "Summarise the SOLID principles in 2 lines." },
  ],
});

console.log(out.choices[0].message.content);

Streaming

const stream = await bee.chat.completions.create({
  model: "bee-cell",
  messages: [{ role: "user", content: "Write a haiku about bees." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

The package code is in the public Bee repo today, but the PyPI cuilabs organisation is still pending approval — meaning pip install bee-sdk will only resolve once that lands. Until then, install directly from GitHub:

# Install from GitHub (recommended while PyPI org approval is pending)
pip install "git+https://github.com/cuilabs/bee.git#subdirectory=sdks/python"

# With async client
pip install "git+https://github.com/cuilabs/bee.git#subdirectory=sdks/python" httpx

Once PyPI org approval lands, the canonical install will be:

pip install bee-sdk          # sync, zero deps
pip install bee-sdk[async]   # adds httpx for the async client

Quickstart

from bee_sdk import Bee

bee = Bee()  # reads BEE_API_URL + BEE_API_KEY from env

print(bee.chat(
    "Explain Shor's algorithm at NISQ depth",
    domain="quantum",
))

Streaming

for chunk in bee.chat_stream(
    "Write a fibonacci function",
    domain="programming",
):
    print(chunk, end="", flush=True)

Async

import asyncio
from bee_sdk import Bee

async def main():
    client = Bee.async_client()  # requires bee-sdk[async]
    result = await client.chat(
        "Audit this code for SQL injection",
        domain="cybersecurity",
    )
    print(result)

asyncio.run(main())