Installation

Outcome. Install the smallest Briefcase AI 4.4.0 package set for your task.

Prerequisites. Python 3.9+ for briefcase-ai; Node.js 20.19+ for Controls and Runtime.

Packages. briefcase-ai, @briefcase-ai/controls, @briefcase-ai/native, @briefcase-ai/runtime

Languages. Python, TypeScript

Choose a package

Python SDK

pip install briefcase-ai==4.4.0

Capture, storage, replay, controls, integrity chains, adapters, and the Python facade over the Rust core.

TypeScript Controls

npm install @briefcase-ai/controls@4.4.0

Invocation gateway, quota ports, retries, suggestion pipeline, Bedrock helpers, semantic conventions, and exporters.

Native Cost Engine

npm install @briefcase-ai/native@4.4.0

Rust-backed model pricing and model-ID normalization with bundled platform binaries.

TypeScript Runtime

npm install @briefcase-ai/runtime@4.4.0

Four subpaths and no root export: /integrity hash chains, a typed /lakefs client, /connectors token-rotating sync, and /trace agent invocation records.

Python extras

Most extras document intent and add no dependency. Provider extras install only the external client they name.

Task	Extras	External dependencies
Observe	otel, gcp-logging, kafka, webhook	OTel, Google Cloud, or Kafka clients where named
Control	controls, guardrails, routing, opa, validate	httpx for OPA only
Verify	replay, drift, integrity, compliance, compliance-kms	PyNaCl or boto3 where named
Store	storage, bitemporal, bitemporal-iceberg, bitemporal-glue, kdb	Provider client where named
Data	lakefs, rag-*, vcs-*, external	Selected lakeFS, vector, or VCS client
Frameworks	langchain, crewai, llamaindex, autogen, ag2, pageindex, openai-agents	Selected framework
Evaluate	evals, gym, mcp	zstandard, Gymnasium, or MCP

pip install "briefcase-ai[controls,integrity,otel]==4.4.0"

kdb+ is intentionally outside all

pykx has separate licensing and is excluded from briefcase-ai[all]. Install briefcase-ai[kdb] only in an environment licensed for kdb+.

Runtime requirements

Python

Python 3.9+. Published wheels contain the Rust core, so consumers do not need a Rust toolchain.

Controls and Runtime

Node.js 20.19+ and ESM. Bedrock peer dependencies are optional until their adapters are imported.

Native

Node.js 12.22+ on Linux x64/arm64 glibc, macOS x64/arm64, or Windows x64.

Next task

Capture your first decision Use the Python SDK to export one instrumented call.

Gate a model call Apply the same controls contract in Python or TypeScript.

Verify an append-only history Build and check a cross-language hash chain.