Install Extras

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

Quick Start

Most users want YAML contracts:

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 contracts as Python functions and do not need YAML files. The core Edictum class, Principal, pipeline, and all contract 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 denied."

YAML Contracts

pip install edictum[yaml]

This is the most common install. Adds PyYAML for parsing contract files and jsonschema for validating them against the Edictum schema. Required for Edictum.from_yaml(), Edictum.from_yaml_string(), and the contract 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.verdict, edictum.contract_id, and edictum.environment. See the telemetry reference for the full attribute list.

CLI

pip install edictum[cli]

Installs the edictum command with validate, check, test, diff, and replay subcommands. The cli extra automatically pulls in yaml (the CLI needs to parse YAML files). See the CLI reference for usage.

Server SDK (Console)

pip install edictum[server]

Adds httpx and httpx-sse for connecting agents to a running Edictum Console instance. This enables remote contract 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 contracts in 5 minutes
• Adapter overview -- choosing the right adapter for your framework
• CLI reference -- command-line tools for contract validation and testing
• Telemetry -- configuring OpenTelemetry export
• Connecting agents to Console -- the server SDK