Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

ICEBOX

ICEBOX protects your AI agent from doing stupid things.

Install

pip install icebox-sdk
icebox init

icebox init asks what you want to protect and sets everything up. No YAML, no policy DSL, nothing to configure.

Use it

from icebox import govern

if govern("Delete EC2 Instance", target="Production AWS"):
    delete_ec2()

That's the whole SDK. Describe the action in plain words; ICEBOX decides whether it's allowed. If govern(...) is truthy, do it. If not, ICEBOX already stopped it and saved the audit entry.

When an action is held or blocked, ICEBOX tells you:

ICEBOX protected Production AWS.

Action:
  Delete EC2 Instance

Decision:
  Approval Required

Your AI agent attempted a dangerous action and was stopped.

Check your protection

icebox doctor
ICEBOX Status

✓ Daemon running
✓ Policy loaded (6 rules)
✓ Audit enabled
✓ Sandbox enabled
✓ Production AWS profile loaded

You're protected.

Examples

ICEBOX works in front of any agent framework. Recipes, not integrations:

Each is a thin wrapper: intercept the tool call, ask govern(), run only when allowed.

The two ideas

  1. Protect something. icebox init sets up the guardrails.
  2. Govern dangerous actions. govern() answers one question: is this allowed?

Everything else — sandboxes, audit trails, approval workflows — is ICEBOX's job, not yours.

Release files for icebox-sdk 1.0.0b0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for icebox-sdk 1.0.0b0
File Interpreter ABI Platform
icebox_sdk-1.0.0b0-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details

Release files / icebox_sdk-1.0.0b0-cp314-cp314-macosx_11_0_arm64.whl

Download URL icebox_sdk-1.0.0b0-cp314-cp314-macosx_11_0_arm64.whl
Size 3.0 MB
Tags CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
f4b33fba9d827680699caa61d641481ea3e2b10e0b0c8286b7c1b95222b9bf10
BLAKE2b-256 checksum
How to use checksums
18d940af64de9e150b0557354343d8e1cb50dd6f45907245bc36a7bda9d366ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release history Release notifications | RSS feed

This release

1.0.0b0 This release

1 release file

0.2.6

2 release files

0.2.5

1 release file

0.2.4

2 release files

0.2.3

3 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page