Packages reference

Namzu publishes one kernel and a set of packages around it. You install the kernel plus only the parts you use; nothing here is bundled by default.

All packages are licensed FSL-1.1-MIT - every published version converts to MIT two years after its release.

Kernel

Package	Responsibility
`@namzu/sdk`	The kernel: runtime, agents, tools, registry, stores, RAG, connectors. This is the one package you always install.

Package	Responsibility
`@namzu/sandbox`	Pluggable sandbox providers - process-level isolation (bubblewrap on Linux, Seatbelt on macOS) and container-level isolation with a JWT-authenticated egress proxy.
`@namzu/telemetry`	OTLP exporter pipeline: traces and metrics, resource attributes, platform metrics.
`@namzu/computer-use`	Subprocess-based `ComputerUseHost` - screenshot, mouse, keyboard.
`@namzu/files`	Provider-agnostic file registry contracts. Contracts, not drivers.
`@namzu/cli`	Operator CLI. Ships `namzu doctor`; usable as a bin or as a library.

One package per vendor. Install exactly one - or several, if you switch at run time. See Choose a provider for guidance.

Package	Vendor or interface
`@namzu/anthropic`	Anthropic Messages API
`@namzu/openai`	OpenAI Chat Completions
`@namzu/bedrock`	AWS Bedrock Converse
`@namzu/openrouter`	OpenRouter, aggregated models
`@namzu/ollama`	Ollama, local
`@namzu/lmstudio`	LM Studio, local, over WebSocket
`@namzu/http`	Any OpenAI- or Anthropic-compatible endpoint. Zero dependencies.

The kernel also carries a pre-registered MockLLMProvider, so @namzu/sdk installed alone runs with no network dependency.


Node.js	20 or later
TypeScript	5.5 or later
Module format	ESM. Every package publishes `types` and an `import` entry point.

Local development, no key:

bash

pnpm add @namzu/sdk @namzu/ollama

Hosted model with tracing and isolation:

bash

pnpm add @namzu/sdk @namzu/anthropic @namzu/telemetry @namzu/sandbox

Tests only - no provider needed:

bash

pnpm add @namzu/sdk