Metadata-Version: 2.4
Name: langchain-chronoverify
Version: 0.1.0
Summary: LangChain tool for ChronoVerify: verify when a photo was taken and its provenance (C2PA Content Credentials, EXIF, pixel forensics).
Project-URL: Homepage, https://chronoverify.com
Project-URL: Documentation, https://chronoverify.com/integrations/langchain
Project-URL: API reference, https://chronoverify.com/method
Project-URL: Source, https://github.com/beeswaxpat/chronoverify-agent-recipes
Author-email: ChronoVerify <support@chronoverify.com>
License-Expression: MIT
Keywords: c2pa,capture-time,content-credentials,exif,image-verification,langchain,provenance
Requires-Python: >=3.9
Requires-Dist: langchain-core<2,>=0.3
Requires-Dist: requests>=2.28
Description-Content-Type: text/markdown

# langchain-chronoverify

LangChain tool for [ChronoVerify](https://chronoverify.com): verify when a photo was taken and its provenance. It reads EXIF and XMP, cryptographically validates C2PA Content Credentials against the official trust lists, and runs classical pixel forensics, returning one plain-language verdict with a confidence score.

Provenance validation, not a deepfake or AI-generation detector. Verdicts are investigative triage to support human review, not proof.

## Install

```bash
pip install langchain-chronoverify
```

## Use

```python
from langchain_chronoverify import ChronoVerifyTool

tool = ChronoVerifyTool()  # keyless: free, rate-limited public path

result = tool.invoke({"url": "https://example.com/photo.jpg"})
print(result["verdict"], result["confidence"])
# verdict is one of: provenance_confirmed, consistent, inconclusive,
# metadata_anomaly, manipulation_indicated
```

With an agent:

```python
from langchain.agents import create_agent  # or your agent constructor

agent = create_agent(model, tools=[ChronoVerifyTool()])
```

## API key (optional)

The keyless path is free and rate limited per IP. For your own quota, pass `api_key="cv_live_..."` or set `CHRONOVERIFY_API_KEY`. A free key (no card, 100 verifications per month):

```bash
curl -X POST https://chronoverify.com/v1/keys/free \
  -H "Content-Type: application/json" -d '{"email": "you@example.com"}'
```

## Links

- Machine-readable onboarding: https://chronoverify.com/v1/onboarding
- API docs: https://chronoverify.com/method
- Response JSON Schema: https://chronoverify.com/v1/verify.schema.json
- Pricing: https://chronoverify.com/pricing
