Bee by HEOSSI — Public Developer Resources

Open community repository for Bee by HEOSSI — public code, developer tooling, documentation, examples, and community-facing components for building with and contributing to Bee.

<!-- mcp-name: io.github.heossihq/bee-public -->

What's here

Path	What
mcp/	Bee MCP Server install instructions for Claude Desktop, Cursor, VS Code, Zed, Windsurf, OpenCode
llms-install.md	AI-agent-readable MCP install guide (Cline & friends)
sdks/typescript/	Pointer + quickstart for @cuilabs/bee (live on npm)
sdks/python/	Pointer + quickstart for bee-sdk (live on PyPI)
examples/typescript/	Working @cuilabs/bee SDK examples (quickstart, streaming, vision)
examples/python/	Working bee-sdk examples
CONTRIBUTING.md	How to file an issue, propose a change, or run a workshop on Bee

SDKs

# TypeScript / JavaScript / Node / Deno / Bun / browsers — live on npm
npm install @cuilabs/bee

# Python (3.10+) — live on PyPI; also ships the `bee-mcp` MCP server
pip install bee-sdk

Full install + quickstart: bee.heossi.com/docs/sdks.

MCP Server (Claude Desktop, Cursor, VS Code…)

Bee ships a hosted MCP server with 14 governed tools spanning intelligence, code, security, research, provenance, usage, documents, memory, and Quantum Reasoning Lab. It supports stdio and request/response Streamable HTTP. Hosted calls are authenticated, tenant-scoped, plan/policy gated, and metered by the Bee gateway.

pip install bee-sdk          # provides the `bee-mcp` console script
export BEE_API_KEY=bee_sk_…  # create at bee.heossi.com/app/account/api-keys
bee-mcp                      # stdio transport — what every desktop client uses

See mcp/ for the exact catalog and per-client configs, or bee.heossi.com/docs/mcp.

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: "What is Bee?" }],
});

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

Get an API key at bee.heossi.com/app/account/api-keys.

What this repo is not

• Not the Bee engine source. The proprietary engine lives in HEOSSI's private monorepo. This repository contains public SDK pointers, MCP install material, examples, and documentation.
• Not a release vehicle. SDKs are released to npm + PyPI. This repo mirrors the source tree of the published packages and links out.
• Not in scope for product support tickets. Use bee.heossi.com/contact for product support; use this repo's issues for SDK, MCP, and example bugs.

Status

• 🟢 bee.heossi.com/status — live service status
• 📍 bee.heossi.com/roadmap — what's next
• 📰 bee.heossi.com/changelog — what shipped

License

Apache-2.0 — © 2026 HEOSSI (Pte.) Ltd.