{
  "uid": "cogitave.learn.docs.packages",
  "kind": "doc",
  "href": "/docs/packages/",
  "title": "Packages reference",
  "summary": "Every published Namzu package and what it is responsible for - the kernel, the sandbox and telemetry layers, the operator CLI, the file registry contracts, and the eight model provider drivers.",
  "type": "reference",
  "products": [
    "namzu"
  ],
  "roles": [
    "developer",
    "platform-engineer"
  ],
  "levels": [
    "beginner"
  ],
  "subjects": [],
  "headings": [
    "Kernel",
    "Platform layers",
    "Provider drivers",
    "Requirements",
    "Install shapes",
    "Next steps"
  ],
  "source": "\n# Packages reference\n\nNamzu publishes one kernel and a set of packages around it. You install the\nkernel plus only the parts you use; nothing here is bundled by default.\n\nAll packages are licensed `FSL-1.1-MIT` - every published version converts to MIT\ntwo years after its release.\n\n## Kernel\n\n| Package | Responsibility |\n|---|---|\n| `@namzu/sdk` | The kernel: runtime, agents, tools, registry, stores, RAG, connectors. This is the one package you always install. |\n\n## Platform layers\n\n| Package | Responsibility |\n|---|---|\n| `@namzu/sandbox` | Pluggable sandbox providers - process-level isolation (bubblewrap on Linux, Seatbelt on macOS) and container-level isolation with a JWT-authenticated egress proxy. |\n| `@namzu/telemetry` | OTLP exporter pipeline: traces and metrics, resource attributes, platform metrics. |\n| `@namzu/computer-use` | Subprocess-based `ComputerUseHost` - screenshot, mouse, keyboard. |\n| `@namzu/files` | Provider-agnostic file registry contracts. Contracts, not drivers. |\n| `@namzu/cli` | Operator CLI. Ships `namzu doctor`; usable as a bin or as a library. |\n\n## Provider drivers\n\nOne package per vendor. Install exactly one - or several, if you switch at run\ntime. See [Choose a provider](choose-a-provider.md) for guidance.\n\n| Package | Vendor or interface |\n|---|---|\n| `@namzu/anthropic` | Anthropic Messages API |\n| `@namzu/openai` | OpenAI Chat Completions |\n| `@namzu/bedrock` | AWS Bedrock Converse |\n| `@namzu/openrouter` | OpenRouter, aggregated models |\n| `@namzu/ollama` | Ollama, local |\n| `@namzu/lmstudio` | LM Studio, local, over WebSocket |\n| `@namzu/http` | Any OpenAI- or Anthropic-compatible endpoint. Zero dependencies. |\n\nThe kernel also carries a pre-registered `MockLLMProvider`, so `@namzu/sdk`\ninstalled alone runs with no network dependency.\n\n## Requirements\n\n| | |\n|---|---|\n| Node.js | 20 or later |\n| TypeScript | 5.5 or later |\n| Module format | ESM. Every package publishes `types` and an `import` entry point. |\n\n## Install shapes\n\nLocal development, no key:\n\n```bash\npnpm add @namzu/sdk @namzu/ollama\n```\n\nHosted model with tracing and isolation:\n\n```bash\npnpm add @namzu/sdk @namzu/anthropic @namzu/telemetry @namzu/sandbox\n```\n\nTests only - no provider needed:\n\n```bash\npnpm add @namzu/sdk\n```\n\n## Next steps\n\n- [Quickstart](quickstart.md)\n- [Choose a provider](choose-a-provider.md)\n- [What Namzu is](what-is-namzu.md) - why the surface is split this way.\n",
  "lastReviewed": "2026-07-26",
  "order": 1
}