Set up Interceptor

Install a complete released package and use a local Docker daemon matching its architecture. Released packages need no local Go toolchain, including for wrapper builds on macOS.

Install the release package

Choose your documented release from official releases or Interceptor releases. Download the OS/architecture archive and its matching checksum file. From the download directory, this macOS ARM64 example installs into a separate version folder:

INTERCEPTOR_VERSION=0.1.5
PLATFORM=darwin_arm64
shasum -a 256 --check "interceptor_sandbox-v${INTERCEPTOR_VERSION}-${PLATFORM}-SHA256SUMS"
mkdir -p "$HOME/.local/lib/interceptor/$INTERCEPTOR_VERSION"
tar -xzf "interceptor_sandbox-v${INTERCEPTOR_VERSION}-${PLATFORM}.tar.gz" \
  -C "$HOME/.local/lib/interceptor/$INTERCEPTOR_VERSION"
export PATH="$HOME/.local/lib/interceptor/$INTERCEPTOR_VERSION/interceptor_sandbox:$PATH"
interceptor version

Set the version to your selection. For Linux, use linux_amd64 or linux_arm64 and sha256sum --check. Keep packages in separate directories when upgrading.

The macOS archive contains interceptor, interceptor-linux, release.json, and license material. Keep them together; the Linux companion runs in the wrapper. Copying only the CLI or mixing companion versions breaks package verification. Linux packages use their native executable for the wrapper. Docker Desktop on macOS and Docker Engine on Linux must run matching native Linux images.

Prepare private host storage

Choose a local private data directory if you need an explicit location:

umask 077
mkdir -p ./interceptor-data
export INTERCEPTOR_DATA_DIR="$PWD/interceptor-data"

Use the same setting in terminals that operate the session. Otherwise Interceptor uses its OS user-configuration directory. The directory contains evidence and host bindings; do not place it in a broadly shared or synchronized folder.

Configure model access

Keep real provider credentials on the host. The agent's blueprint uses the local model endpoint and declared synthetic SDK credentials. Choose the generation provider, base URL, authentication method, and allowed model explicitly.

For OpenAI Chat with a host variable already populated securely, the relevant interceptor run options are:

--model-provider openai-chat \
--provider-base-url https://api.openai.com/v1 \
--provider-auth api-key-env \
--model-api-key-env TARGET_MODEL_KEY \
--allow-model YOUR_TARGET_MODEL

These are options to the full run command, not a command by themselves. Substitute an available model. The target's blueprint model name must match the allowed model. The variable's value does not go in command arguments or blueprint assets.

If the target uses remote OpenAI embeddings, configure them independently:

--embeddings-provider openai-compatible \
--embeddings-base-url https://api.openai.com/v1 \
--embeddings-auth api-key-env \
--embeddings-api-key-env TARGET_EMBEDDING_KEY \
--allow-embedding-model text-embedding-3-large

Generation settings and credentials are not inherited by embeddings. The host may explicitly use the same credential for both, but each connector is selected separately. Native Bedrock Titan uses bedrock-titan, AWS authentication, and its own regional model selection. It is not interchangeable with an OpenAI embeddings endpoint.

Use the selected release's model-provider reference for other native APIs and credential stores for host secret references. Choose your release tag for version-sensitive options.

Verify the installation through a target

Check interceptor version, Docker availability, and the complete package layout. Then prepare an agent, validate/seal its blueprint, build and verify its wrapper, start a session, and invoke a legitimate operation. A CLI version check or available key alone does not verify model access or the target's dependencies.

interceptor run owns the local API at http://127.0.0.1:8080 and remains in the foreground. One active instance is supported on a trusted local host. No separate gateway or service manager is needed for the walkthrough. Keep its terminal open until Operator finishes and you have collected evidence.