rootzerovault 4.0.0

Root Zero Vault — Constitutional AI Governance SDK

rootzerovault

Constitutional AI Governance SDK for Python — connects your AI agents and tools to the Root Zero Vault constitutional gateway.

Install

pip install rootzerovault

Quick start (live gateway)

from rootzerovault import RzvClient

rzv = RzvClient(gateway="http://localhost:8443")
result = rzv.validate(specimen)
print(result.outcome)  # 'ACCEPT' | 'REJECT'

Quick start (offline / demo mode)

For tests, demos, or offline development without a gateway, use demo_mode=True:

from rootzerovault import RzvClient

rzv = RzvClient(demo_mode=True)
# Governance calls return simulated outcomes instead of raising RzvNotConfiguredError.
# All adapters propagate this through their internal GovernanceClient.

Important: demo_mode is for tests and demos only — never use in production. Without gateway and without demo_mode=True, calls that need governance fail closed with RzvNotConfiguredError.

Framework adapters

Out-of-the-box wrappers for common AI/agent frameworks. Each adapter constructs a GovernanceClient that propagates the demo_mode flag from the RzvClient you pass in.

• LangChain — from rootzerovault.adapters import governed_langchain_tool, GovernedTool
• CrewAI — from rootzerovault.adapters import governed_crewai_tool, GovernedCrew
• OpenAI Agents — from rootzerovault.adapters import governed_openai_agents_tool
• Anthropic — from rootzerovault.adapters import GovernedAnthropic
• AWS Bedrock — from rootzerovault.adapters import GovernedBedrockClient
• Google Vertex / Gemini — from rootzerovault.adapters import governed_vertex_tool
• Azure OpenAI — from rootzerovault.adapters import governed_azure_openai
• Cohere — from rootzerovault.adapters import governed_cohere
• MCP (Model Context Protocol) — from rootzerovault.adapters import GovernedMCPServer, governed_tool
• A2A (Agent-to-Agent) — from rootzerovault.adapters import GovernedA2AAgent
• ANP (Agent Network Protocol) — from rootzerovault.adapters import governed_anp
• ACP — from rootzerovault.adapters import GovernedACPAgent
• Agno — from rootzerovault.adapters import GovernedAgnoAgent
• Semantic Kernel — from rootzerovault.adapters import governed_semantic_kernel
• Smolagents — from rootzerovault.adapters import GovernedSmolTool
• PydanticAI — from rootzerovault.adapters import governed_pydantic_ai
• HTTP — from rootzerovault.adapters import HttpAdapter
• Database / SQL — from rootzerovault.adapters import governed_database
• gRPC — from rootzerovault.adapters import governed_grpc

Optional dependencies are listed under pyproject.toml [project.optional-dependencies]. Install with the framework you need:

pip install rootzerovault[langchain]
pip install rootzerovault[crewai]
pip install rootzerovault[mcp]
# or all at once:
pip install rootzerovault[all]

Genesis

Constitutional anchor — frozen since March 14, 2026. Cannot be backdated. Cannot be altered.

cvid:blake3:1544ff7dd978d911083bd60a7a4e6ba9647996bfdefb62aa8a045ccb63158867

Testing

pip install -e ".[dev]"
python -m pytest tests/

Tests fall into three implicit categories: unit tests (no optional deps required), adapter tests (each requires its framework's optional dep installed; skipped otherwise), and live-gateway tests (require a running gateway at http://localhost:8443).

License

Dual MIT OR Apache-2.0.

Links

• Source: https://github.com/deensaleh/rsbis-sdk
• Issues: https://github.com/deensaleh/rsbis-sdk/issues
• Project: https://rootzerovault.com