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.
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 @heossi/bee (live on npm) |
sdks/python/ | Pointer + quickstart for bee-sdk (live on PyPI) |
examples/typescript/ | Working @heossi/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 @heossi/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 workspace.bee.heossi.com/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 "@heossi/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 workspace.bee.heossi.com/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.