Skip to main content

Python SDK for Gavrun — govern AI agents before risky actions execute

Project description

gavrun

Python SDK for Gavrun — govern AI agents before risky actions execute.

Gavrun intercepts agent tool calls, evaluates them against your policies, and requires human approval for high-risk actions before they run.

Install

pip install gavrun

Quick start

import gavrun

gavrun.configure(
    api_key="your-sdk-key",       # from agentmanager.gavrun.ai/api-keys
    agent_name="my-agent",
    agent_manager_url="https://api.gavrun.ai",
)

Tool calls are governed automatically for LangChain, LangGraph, CrewAI, and OpenAI Agents SDK via auto-patch. For manual guarding:

client = gavrun.get_client()

result = client.guard(
    action="delete_user",
    execute=lambda: delete_user(user_id),
    tools=["delete_user"],
    prompt=f"Delete user {user_id}",
)

if result.denied:
    raise PermissionError("Blocked by policy")
if result.requires_human_review:
    # poll for approval
    ...

Frameworks

Auto-patch wires governance into every tool call:

import gavrun
gavrun.configure(api_key="...", agent_manager_url="https://api.gavrun.ai")
# LangChain, LangGraph, CrewAI, OpenAI Agents SDK tools are now governed

Links

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

gavrun-0.2.5.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

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

gavrun-0.2.5-py3-none-any.whl (13.0 kB view details)

Uploaded Python 3

File details

Details for the file gavrun-0.2.5.tar.gz.

File metadata

  • Download URL: gavrun-0.2.5.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gavrun-0.2.5.tar.gz
Algorithm Hash digest
SHA256 bd80f2e37a62e66cf609c838c4ecbe3b13719688f7c595f4a8f315ebd4786f1c
MD5 c602922392a31f515384e7cfe1e5e767
BLAKE2b-256 431972f578dce55eac03381ed600d972e59c56f2479af3a2e9d5bba41986b7bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for gavrun-0.2.5.tar.gz:

Publisher: publish-gavrun.yml on gavrun-ai/gavrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file gavrun-0.2.5-py3-none-any.whl.

File metadata

  • Download URL: gavrun-0.2.5-py3-none-any.whl
  • Upload date:
  • Size: 13.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gavrun-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c4c0a8d3eddff680d358fb5579d267afb1686d5756b384f39b77b79910bcf418
MD5 d2aa78378b388aa45fbcb45a6cabb7f1
BLAKE2b-256 6b28597f6024309a681b36d342266044bcef789a14ea043147e7972c4cfb43e9

See more details on using hashes here.

Provenance

The following attestation bundles were made for gavrun-0.2.5-py3-none-any.whl:

Publisher: publish-gavrun.yml on gavrun-ai/gavrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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