Bee Intelligence Engine

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 @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.