Skip to main content

Deterministic safety for AI agents. Mathematics, not prompts.

Project description

EvrGuard

Python 3.9+ License: MIT PyPI version

Deterministic safety for AI agents. Mathematics, not prompts.


What is EvrGuard?

EvrGuard wraps any AI agent with mathematical safety verification. Every action is checked against constitutional rules using neuro-symbolic gradient steering. Every decision carries a cryptographic proof.

Not AI watching AI. Mathematics governing AI.

Quick Start

from evrguard import EvrmindGuard

guard = EvrmindGuard(api_url="https://evrguard.up.railway.app")

@guard.wrap_tool
def execute_query(sql):
    return db.execute(sql)

That is the entire integration. Three lines plus a decorator on each guarded tool.

Installation

pip install evrguard

Python 3.9 or newer. The only runtime dependency is requests (the SDK falls back to the standard library urllib if it is not present).

MCP Server for Claude Code

EvrGuard ships an MCP server. Add to your .mcp.json:

{
  "mcpServers": {
    "evrguard": {
      "command": "python",
      "args": ["-m", "evrguard.mcp_server"],
      "env": {
        "EVRGUARD_API_URL": "https://evrguard.up.railway.app"
      }
    }
  }
}

Restart Claude Code. The evrguard_verify tool is now available to the agent for every action.

Features

  • Triple-layer detection — pattern matching, geometric safety net, and intent analysis. 97.3% hostile catch rate on the OWASP Agentic AI red-team baseline (87/87).
  • Neuro-symbolic gradient steering — does not just block. Steers the agent toward a compliant alternative on a 32-dimensional constitutional manifold.
  • Cryptographic proofs — every verdict carries an HMAC-SHA256 signature and a Merkle-anchored proof hash. Verifiable by any auditor.
  • 10 industry constitutions — pre-built rule sets for finance, healthcare, legal, devops, retail, education, insurance, government, critical infrastructure, and general enterprise.
  • OWASP Agentic Top 10 — preset compliance pack covering all ten agentic AI threats.
  • Monitor mode — log verdicts without blocking. Run for a week before enforcing.
  • Allowlist mode — for maximum control, allow only explicitly permitted actions and block everything else.

Industry Constitutions

Industry Rules Use For
General Enterprise 12 Any business using AI agents
Financial Services 14 Banks, trading, fintech, payments
Healthcare 12 Hospitals, clinics, health tech
Legal 11 Law firms, legal tech, compliance
DevOps / Engineering 12 Software teams, coding agents
Retail / E-commerce 11 Online retailers, marketplaces
Education 10 Schools, universities, edtech
Insurance 12 Insurers, brokers, insurtechs
Government 12 Public sector, civil service
Critical Infrastructure 14 Energy, water, telecoms, transport

All ten templates ship in the constitutions/ directory.

Integration Examples

Framework Example
LangChain examples/langchain_integration.py
LangGraph examples/langgraph_integration.py
AutoGen examples/autogen_integration.py
CrewAI examples/crewai_integration.py
Claude Code examples/claude_code_setup.md
OpenClaw examples/openclaw_setup.md

Hardware Enforcement

For environments requiring physical enforcement, the same constitutional rules compile to the Evrmind safety processor on dedicated silicon. 7.47 ns interdiction. Same constitution. Two layers.

Learn more at labs.evrmind.io.

How it Works

   action ─▶  Layer 1: Pattern Matcher  ─▶
              Layer 2: Geometric Safety Net  ─▶
              Layer 3: Intent Analysis  ─▶  verdict + proof

The verification engine runs on the hosted EvrGuard API. The Python SDK in this repository is the open-source integration layer.

Licence

MIT. See LICENCE.

Copyright © 2026 Evrmind Limited.


labs.evrmind.io · GitHub · PyPI

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

evrguard-0.1.0.tar.gz (13.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

evrguard-0.1.0-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file evrguard-0.1.0.tar.gz.

File metadata

  • Download URL: evrguard-0.1.0.tar.gz
  • Upload date:
  • Size: 13.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for evrguard-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e20f02a857ac26f6f9a0d035577bcb078bf2aa66254817334e8bdca8ad48fc81
MD5 bcb49958905401076dd74f50e030c8ce
BLAKE2b-256 a10a6c483fa67800db43e4ffed5e7b4fea33e888f79b911f0008017eeed7ebe9

See more details on using hashes here.

File details

Details for the file evrguard-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: evrguard-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 12.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for evrguard-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7429f16390dbc947ac95bf38be194f39d3a1af2f5842f2f8dfdf6c6e9add70cd
MD5 d0a5f0c01622652ae46380340067f096
BLAKE2b-256 5e219e2cf687007b028c14e9844a673ce29766708b812c8b025138276d3d8909

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page