Install Extras

Edictum has zero required dependencies. The base install gives you the core pipeline and Python rule support. Everything else is opt-in through pip extras.

Quick Start

Most users want YAML rules:

pip install edictum[yaml]

Need observability too? Combine extras with commas:

pip install edictum[yaml,otel]

Want everything:

pip install edictum[all]

All Extras

Choosing Your Extras

Base Install (zero dependencies)

pip install edictum

Use this when you write rulesets as Python functions and do not need YAML files. The core Edictum class, Principal, pipeline, and all rule types work without any dependencies.

from edictum import Edictum, Principal

guard = Edictum()

@guard.pre(tools=["read_file"])
def block_dotenv(tool_name, args, principal):
    if args.get("path", "").endswith(".env"):
        return "Sensitive file blocked."

YAML Rulesets

pip install edictum[yaml]

This is the most common install. Adds PyYAML for parsing rule files and jsonschema for validating them against the Edictum schema. Required for Edictum.from_yaml(), Edictum.from_yaml_string(), and the rule generator.

Observability

pip install edictum[yaml,otel]

Adds the OpenTelemetry SDK and OTLP exporter. Every tool call evaluation emits an edictum.evaluate span with attributes like edictum.tool, edictum.decision, edictum.decision.name, and edictum.environment. See the telemetry reference for the full attribute list.

Canonical CLI

go install github.com/edictum-ai/edictum-go/cmd/edictum@latest

The canonical edictum CLI now ships from edictum-go. Use it for validate, check, test, diff, replay, skill scan, and Gate runtime commands. See the CLI reference for usage.

Server SDK (Control Plane)

pip install edictum[server]

Adds httpx and httpx-sse for connecting agents to a running Edictum Control Plane instance. This enables remote rule management, human-in-the-loop approvals, fleet monitoring, and centralized audit feeds.

Framework Adapters

Install the extra matching your AI framework:

pip install edictum[langchain]        # LangChain
pip install edictum[crewai]           # CrewAI
pip install edictum[agno]             # Agno
pip install edictum[semantic-kernel]  # Semantic Kernel
pip install edictum[openai-agents]    # OpenAI Agents SDK

Each extra installs only the framework's core library as a dependency. You still need the framework itself installed in your project. The extras ensure version compatibility.

Common Combinations

Version Constraints

Each extra specifies minimum compatible versions:

Next Steps

• Quickstart -- get running with YAML rulesets in 5 minutes
• Adapter overview -- choosing the right adapter for your framework
• CLI reference -- command-line tools for rule validation and testing
• Telemetry -- configuring OpenTelemetry export
• Connecting agents to Control Plane -- the server SDK