OPEN SOURCE · v0.1.0-alpha.1

Evidence-based guardrails
for AI agents

Your team defines the checks in a Spec. The agent investigates and submits evidence. The execution tool verifies the decision and evidence before acting.

Apache 2.0 Self-hosted HTTP API + CLI

Code rollout · example pre-resume check

The first batch is live. Can the next batch proceed?

After the first batch deploys, the on-call engineer checks metrics, logs and alerts before deciding whether to roll out the second batch. At Alibaba, we use Guardrail for this check in production. This local example follows the Spec to trace a failed write to a synthetic order.

Evidence sourceWhat the agent finds
Metrics and alertsThe agent checks the error rate and active alerts for the first batch. The error rate is within the threshold and there are no active alerts.
Error logsNew write errors appear on those same instances after deployment.
Code and dataThe diff touches the failing write path. A read-only lookup shows payment for order-42 was captured while the order is still pending.

BLOCKED · The write failures affected business data. The agent submits its findings and evidence, Guardrail records DENY. This local example has no connection to a release system. In a live rollout, the execution tool applies the decision to pause or resume.

Watch the 30-second run How to inspect a Run report

THE EXECUTION CHECKPOINT

From policy to verified action.

01

Define

Publish the checks and evidence requirements.

02

Submit

Your agent performs checks and submits evidence.

03

Decide

Read the recorded ALLOW or DENY and its validity.

04

Verify and act

The tool verifies evidence and permissions before acting.

Try OpenGuardrail locally

For the source walkthrough, use Git, Make, Python 3.9+, the Go version in go.mod and a coding agent with shell access (Claude Code, Cursor, Codex, etc.).

Follow the complete guide
git clone https://github.com/alibaba/open-guardrail.gitcd open-guardrail

First-batch rollout scenario: open the checkout in your coding agent and ask: Use $open-guardrail-demo to check the first batch and tell me whether the next batch can proceed.

OPTIONAL FILE CLEANUP

Change the request. See the decision.

Two of these four files are protected. Try selecting only temporary files.

01 / Cleanup requestfile-cleanup
Select target files
02 / AssessmentLOCAL ILLUSTRATION
Awaiting assessment—
Only temporary files—
At most 2 files—

Try selecting only the .tmp files, or turn off evidence to see UNKNOWN → DENY.

Browser illustration · no service calls or file operations

Run the real cleanup demo