Bee — The Progressive Intelligence Engine

io.github.cuilabs/bee

Documentation

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