Skip to main content

quint-agent

Behavioral telemetry and policy enforcement for AI agents.

PyPI CI License: Apache 2.0

Capture every prompt, tool call, and tool result from your AI agents. Enforce YAML-defined policy at the tool-call boundary. Stream telemetry to the Quint cloud for behavioral analysis and divergence detection.

Install

pip install quint-agent

With auto-instrumentation (zero code change):

pip install 'quint-agent[otel-openai]'     # auto-capture OpenAI calls
pip install 'quint-agent[otel-anthropic]'   # auto-capture Anthropic calls
pip install 'quint-agent[otel-langchain]'   # auto-capture LangChain chains
pip install 'quint-agent[otel-all]'         # all frameworks

With framework integrations:

pip install 'quint-agent[anthropic]'   # guarded_dispatch for Anthropic
pip install 'quint-agent[langchain]'   # QuintCallbackHandler
pip install 'quint-agent[mcp]'         # QuintMCPClient
pip install 'quint-agent[all]'         # everything

Zero-code observability (2 lines)

import quint_agent

quint_agent.init(api_key="qak_...")
# That's it. Every OpenAI/Anthropic/LangChain call is auto-captured.

If OTel instrumentors are installed ([otel-openai], [otel-anthropic], etc.), quint.init() auto-detects and instruments them. No decorators, no callbacks, no code changes.

@quint.guard — policy enforcement

import quint_agent

quint_agent.init(api_key="qak_...")

@quint_agent.guard()
def read_file(path: str) -> str:
    return open(path).read()

@quint_agent.guard()
def run_command(cmd: str) -> str:
    import subprocess
    return subprocess.check_output(cmd, shell=True, text=True)

read_file(path="/etc/hosts")        # allowed — captured to cloud
read_file(path="/home/me/.env")     # blocked — ToolBlockedError

Anthropic integration

import anthropic
import quint_agent
from quint_agent.integrations.anthropic import guarded_dispatch

quint_agent.init(api_key="qak_...")

tools_map = {"read_file": read_file}
client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    tools=[{"name": "read_file", "description": "Read a file", "input_schema": {
        "type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]
    }}],
    messages=[{"role": "user", "content": "Read /etc/passwd"}],
)

for block in response.content:
    if block.type == "tool_use":
        result = guarded_dispatch(block.name, block.input, tools_map)

LangChain

from quint_agent.integrations.langchain import QuintCallbackHandler

chain.invoke({"input": "..."}, config={"callbacks": [QuintCallbackHandler()]})

MCP

from quint_agent.integrations.mcp import QuintMCPClient

async with mcp_client() as session:
    guarded = QuintMCPClient(session)
    result = await guarded.call_tool("read_file", {"path": "/x"})

Custom policy

# my_policy.yaml
rules:
  - name: no_prod_db
    action: block
    reason: "Production database access not allowed"
    when:
      - op: equals
        path: tool_name
        value: execute_sql
      - op: contains
        path: args.connection
        value: prod
quint_agent.init(api_key="qak_...", policy="my_policy.yaml")

Default policy

Ships with 4 rules out of the box:

  • Block .env file reads
  • Block AWS credentials access
  • Escalate on secrets/ directory reads
  • Block destructive shell commands (rm -rf /)

Override by passing your own policy to quint.init(policy=...).

Docs

Full documentation at docs.quintai.dev/sdk.

License

Apache 2.0 — see LICENSE.

Built by Quint Security.

Metadata

Release files for quint-agent 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for quint-agent 0.2.0
File Size Uploaded Provenance Actions
quint_agent-0.2.0.tar.gz 187.7 kB With provenance Details for quint_agent-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for quint-agent 0.2.0
File Interpreter ABI Platform Actions
quint_agent-0.2.0-py3-none-any.whl Python 3 none any Details for quint_agent-0.2.0-py3-none-any.whl

Total release size: 213.3 kB

Release files / quint_agent-0.2.0.tar.gz

Download URL quint_agent-0.2.0.tar.gz
Size 187.7 kB
Tags Source
SHA-256 checksum
How to use checksums
db27c40a53b7bf681f940cdcbc2bfc9c15c6a05295aad02bbd5a99a97e223a47
BLAKE2b-256 checksum
How to use checksums
088f7e4fb6285e61382d9e58dd7506f0ffebca049e79bdd8b411c35d3d5c9526
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 27, 2026.

Transparency log

Release files / quint_agent-0.2.0-py3-none-any.whl

Download URL quint_agent-0.2.0-py3-none-any.whl
Size 25.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5fd46d0c46106c31817fea193e0ab250f8857fa114373221b9f31ca0ae84d5b4
BLAKE2b-256 checksum
How to use checksums
f611a4121b6099af9c29a30e1b50b170ba8839969a0ad88e67a663cda0c88ec8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 27, 2026.

Transparency log

Security for quint-agent 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for quint_agent-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 27, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page