{
  "markdown": "<p align=\"center\"><img src=\"./assets/bee-logo-400.png\" alt=\"Bee by HEOSSI\" width=\"120\"></p>\n\n# Bee by HEOSSI\n\n[![npm](https://img.shields.io/npm/v/%40heossihq%2Fbee?label=npm)](https://www.npmjs.com/package/@heossihq/bee)\n[![PyPI](https://img.shields.io/pypi/v/bee-sdk?label=PyPI)](https://pypi.org/project/bee-sdk/)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.heossihq%2Fbee--public-6f42c1)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.heossihq/bee-public)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](./LICENSE)\n\n[Website](https://bee.heossi.com) | [Documentation](https://bee.heossi.com/docs) | [Packages](./PACKAGES.md) | [Machine-readable package index](./PACKAGE-INDEX.json) | [System status](https://bee.heossi.com/status)\n\nThe public developer distribution for [Bee](https://bee.heossi.com), HEOSSI's governed multimodal intelligence platform. This repository contains the actual source of Bee's Apache-2.0 SDKs, MCP integration, API contracts, runnable examples, and public trust-verification material.\n\n> This repository is generated from reviewed, public-safe paths in the Bee monorepo. [MANIFEST.json](./MANIFEST.json) records the exact source commit and content digest for every export; [SHA256SUMS](./SHA256SUMS) and the [SPDX SBOM](./SBOM.spdx.json) support independent artifact inspection.\n\n<!-- mcp-name: io.github.heossihq/bee-public -->\n\n## Developer surface\n\nThe canonical [package catalog](./PACKAGES.md) records each public developer distribution, exact version, registry, role, license boundary, and install command. Its machine-readable companion is [`PACKAGE-INDEX.json`](./PACKAGE-INDEX.json). These distributions do not expose the private Bee service monorepo.\n\n| Surface | Install or entry point | Source / contract |\n| --- | --- | --- |\n| TypeScript SDK | `npm install @heossihq/bee` | [`sdks/typescript`](./sdks/typescript) |\n| Python SDK | `pip install bee-sdk` | [`sdks/python`](./sdks/python) |\n| MCP server | `uvx --from bee-sdk@latest bee-mcp` | [`mcp`](./mcp) · [`server.json`](./sdks/python/server.json) |\n| OpenAI-compatible API | `https://api.bee.heossi.com/bee` | [`openapi.json`](./api/openapi.json) · [`postman.json`](./api/postman.json) |\n| BEE Code for VS Code | `Heossi.beecode` | [Microsoft Marketplace](https://marketplace.visualstudio.com/items?itemName=Heossi.beecode) · [Open VSX](https://open-vsx.org/extension/Heossi/beecode) |\n| Bee Code CLI | `npm install -g @heossihq/beecode` | [Download guide](https://bee.heossi.com/download) |\n| PQ assurance | Signed public coverage register | [`trust/pq-register`](./trust/pq-register) |\n\n## Quickstart\n\n```ts\nimport { BeeClient } from \"@heossihq/bee\";\n\nconst bee = new BeeClient({ apiKey: process.env.BEE_API_KEY! });\nconst result = await bee.chat.completions.create({\n  model: \"bee-cell\",\n  messages: [{ role: \"user\", content: \"Explain hybrid post-quantum TLS.\" }],\n});\n\nconsole.log(result.choices[0].message.content);\n```\n\nCreate an API key in [Bee Workspace](https://workspace.bee.heossi.com/account/api-keys). The free Cell tier works with both SDKs and MCP.\n\n## Repository map\n\n```text\napi/                 Versioned OpenAPI and Postman contracts\ndocs/                Public architecture and enterprise scenario flows\nexamples/            Runnable TypeScript and Python examples\nmcp/                 Client configuration and MCP setup\nsdks/typescript/     Published @heossihq/bee package source and tests\nsdks/python/         Published bee-sdk and bee-mcp source and tests\ntrust/pq-register/   Public PQ coverage register and offline verification tools\n```\n\n## Enterprise evaluation paths\n\n| Evaluator | Start here | What can be verified publicly |\n| --- | --- | --- |\n| Enterprise architect | [Reference architecture](./docs/architecture.md) and [scenario flows](./docs/scenarios/README.md) | System boundaries, governed request flow, deployment profiles, and responsibility split |\n| Security or risk lead | [Security policy](./SECURITY.md), [PQ coverage register](./trust/pq-register/), and [diligence index](./docs/enterprise-diligence.md) | Disclosure path, released PQ claims, evidence limitations, and public control references |\n| Platform engineer | [API contracts](./api/), [SDKs](./sdks/), [MCP](./mcp/), and [examples](./examples/) | Integration contracts, install paths, source, examples, and client configuration |\n| Procurement or technical diligence | [MANIFEST.json](./MANIFEST.json), [SHA256SUMS](./SHA256SUMS), [SPDX SBOM](./SBOM.spdx.json), and [NOTICE](./NOTICE) | Export provenance, file integrity, package inventory, licensing, and the public/proprietary boundary |\n\n## Architecture and scenarios\n\nStart with the [public reference architecture](./docs/architecture.md), then\nfollow the control boundary through three concrete flows:\n\n- [governed coding in an IDE](./docs/scenarios/bee-code.md)\n- [tenant-scoped knowledge retrieval](./docs/scenarios/tenant-rag.md)\n- [explicit quantum reasoning](./docs/scenarios/quantum-reasoning.md)\n\nThe matching visual architecture centre is published at\n[bee.heossi.com/docs/architecture](https://bee.heossi.com/docs/architecture).\n\nBee Code's agent path is durable, subscription-bounded, and independently\nmetered. Workspace, mobile, desktop, SDK, and MCP requests retain their own\ndocumented execution contracts; common entitlement enforcement does not imply\nthat every surface has local IDE tools.\n\n## Integrity and provenance\n\nThe public distribution is locally rendered from an allowlisted monorepo\nsurface. Verify it with:\n\n```bash\nsha256sum --check SHA256SUMS\npython3 scripts/verify_bee_package_index.py PACKAGE-INDEX.json\n```\n\n`SHA256SUMS` covers every exported payload file except itself and the\ncommit-specific `MANIFEST.json`. The manifest separately binds the export to\nits source commit and contains a deterministic digest of the complete payload.\nThe SPDX document is package-level (`filesAnalyzed: false`); it inventories the\npublished SDK and MCP packages without claiming a binary or deployment SBOM.\n\n## Public and proprietary boundary\n\nThe files in this repository are Apache-2.0 licensed. Bee's model engine, orchestration plane, hosted gateway, Bee Code CLI implementation, editor-extension implementation, and commercial applications remain proprietary and are not represented as open source here. Public API and package behavior is defined by the contracts and SDK source in this repository.\n\n## Support and security\n\n- SDK, MCP, contract, or example defect: [open an issue](https://github.com/heossihq/bee-public/issues)\n- Product or account support: [bee.heossi.com/contact](https://bee.heossi.com/contact)\n- Vulnerability disclosure: `bee-security@heossi.com`; see [SECURITY.md](./SECURITY.md)\n- Service health: [status](https://bee.heossi.com/status) · [changelog](https://bee.heossi.com/changelog) · [roadmap](https://bee.heossi.com/roadmap)\n\n## Contributing\n\nRead [CONTRIBUTING.md](./CONTRIBUTING.md), [SUPPORT.md](./SUPPORT.md), and the [Code of Conduct](./CODE_OF_CONDUCT.md). Generated paths must be changed in their canonical monorepo source; community examples and documentation can be proposed here and are reconciled during the next local export.\n\n## License\n\n[Apache License 2.0](./LICENSE) · Copyright 2026 HEOSSI (Pte.) Ltd.\n",
  "bytes": 7299,
  "sha": "af009845ddc8cd64d568498ef2e26b4e4c8d378565413e403b325ab5aaaaa33f",
  "repo_slug": "cuilabs/bee-community",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cuilabs_bee_3990ebb2/readme"
}