Installation

Install predicate-secure for your preferred language.

Python Installation

Basic installation

pip install predicate-secure

With framework-specific extras

# For browser-use agents
pip install predicate-secure[browser-use]

# For Playwright automation

Development installation

git clone https://github.com/PredicateSystems/predicate-secure.git
cd predicate-secure
pip install -e ".[dev]"

TypeScript Installation

Basic installation

npm install @predicatesystems/predicate-secure

With framework-specific peer dependencies

# Python installation shown in previous section

Development installation

git clone https://github.com/PredicateSystems/predicate-secure-ts.git
cd predicate-secure-ts
npm install
npm run build

Sidecar Prerequisite (Optional)

The Predicate Authority Sidecar is only required if you need pre-action authorization—real-time policy evaluation that blocks unauthorized actions before they execute.

Feature	Sidecar Required?
Pre-action authorization (`strict`/`permissive` modes)	Yes
Debug tracing (`debug` mode)	No
Audit logging (`audit` mode)	No
Policy development & testing	No

If you only need debug tracing, audit logging, or policy development, you can skip the sidecar entirely.

Starting the Sidecar

Option A: Docker (Recommended)

docker run -d -p 8787:8787 ghcr.io/predicatesystems/predicate-authorityd:latest

Option B: Download Binary

Platform	Binary
macOS (Apple Silicon)	`predicate-authorityd-darwin-arm64.tar.gz`
macOS (Intel)	`predicate-authorityd-darwin-x64.tar.gz`
Linux (x64)	`predicate-authorityd-linux-x64.tar.gz`
Linux (ARM64)	`predicate-authorityd-linux-arm64.tar.gz`
Windows (x64)	`predicate-authorityd-windows-x64.zip`

# macOS (Apple Silicon)
curl -fsSL https://github.com/PredicateSystems/predicate-authority-sidecar/releases/latest/download/predicate-authorityd-darwin-arm64.tar.gz | tar -xz
chmod +x predicate-authorityd
./predicate-authorityd --port 8787

# Linux x64
curl -fsSL https://github.com/PredicateSystems/predicate-authority-sidecar/releases/latest/download/predicate-authorityd-linux-x64.tar.gz | tar -xz
chmod +x predicate-authorityd
./predicate-authorityd --port 8787

See all platform binaries for Linux ARM64, macOS Intel, and Windows.

Verify it's running

curl http://localhost:8787/health
# {"status":"ok"}

The sidecar handles policy evaluation in <25ms with zero egress—no data leaves your infrastructure.

Overview

Quick Start