Skip to main content

agentavow-pydantic

Formerly agentgraph-pydantic. This distribution is now published as agentavow-pydantic. The import module is unchanged — import agentgraph_pydantic still works.

Trust verification middleware for PydanticAI agents

Status: Early Development — feedback welcome

Install

pip install agentgraph-pydantic

Quick Start

from agentgraph_pydantic import TrustGuard, check_trust

# Quick one-shot check
result = await check_trust("crewAIInc/crewAI")
if result.allowed:
    print(f"{result.grade} ({result.score}) — safe to execute")

# Reusable guard with a minimum tier
guard = TrustGuard(min_tier="standard")
result = await guard.check("owner/repo")
if not result.allowed:
    raise ValueError(f"Blocked: {result.reason}")

What This Does

agentgraph-pydantic lets PydanticAI agents verify the trust score of any GitHub repository before executing tools, calling external code, or loading MCP servers. It queries the AgentGraph Trust Gateway and returns a typed TrustResult with score, grade, tier, and category breakdowns — no AgentGraph account required for basic checks.

API

check_trust(repo, min_tier="standard") -> TrustResult

Convenience function for a single trust check.

TrustGuard(min_tier, api_url=None, timeout=30.0)

Reusable guard object. Call await guard.check(repo) to verify trust.

TrustResult

Field Type Description
repo str Repository checked
allowed bool Whether the repo meets the minimum tier
score int Trust score (0-100)
grade str Letter grade (A+/A/B/C/D/F)
tier str Trust tier (verified/trusted/standard/minimal/restricted/blocked)
reason str Human-readable decision reason
category_scores dict[str, int] Per-category score breakdown

How It Differs from agentgraph-bridge-pydantic

  • agentgraph-pydantic (this package) — trust verification middleware. Checks whether external tools/repos are safe to use. No account needed.
  • agentgraph-bridge-pydantic — registration bridge. Registers your PydanticAI agents on the AgentGraph network. Requires an API key.

Documentation

Full docs at agentavow.com/docs

Contributing

This package is in early development. We welcome issues, feedback, and PRs.

Download files

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

Source Distribution

agentavow_pydantic-0.2.0.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

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

agentavow_pydantic-0.2.0-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file agentavow_pydantic-0.2.0.tar.gz.

File metadata

  • Download URL: agentavow_pydantic-0.2.0.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for agentavow_pydantic-0.2.0.tar.gz
Algorithm Hash digest
SHA256 4b4c4d6bd56dcfbe2c2ed8eca04a5cf771fc3a6aff99dd861006c6453da603a6
MD5 d01042995c41758a128ed18132257f95
BLAKE2b-256 1cbac836697de1c86b0b80134c2298036a6bacd96651c298bb12f5aa1f915f44

See more details on using hashes here.

File details

Details for the file agentavow_pydantic-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agentavow_pydantic-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2f809c60cab8a0841f4a8c15c1292d5b4cd034c242aa70cf4167cfaf86039b64
MD5 1a21f7f634b918f1015dd1efb00402fa
BLAKE2b-256 8561d7b5e04f7c13045c43d8f1b8cedebdf5510f35ff44abca21ad04559f1bba

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 Sentry Error logging StatusPage Status page