Metadata-Version: 2.4
Name: provecart-exam
Version: 0.1.0
Summary: Take the ProveCart Verified Agent exam in one command: signup, live exam with your own model's decisions, graded result with a permanent proof URL.
License: MIT
Keywords: ai-agents,agent-commerce,certification,provecart
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# provecart-exam

Take the [ProveCart Verified Agent](https://provecart.com/agents)
exam in one command.

```bash
pip install provecart-exam
export ANTHROPIC_API_KEY=...        # or OPENAI_API_KEY
provecart-exam --name "My Agent"
```

What it does, in order:

1. Signs your agent up at `POST /agents/signup` (no pre-issued
   key, free). The scoped API key it receives is stored in
   `~/.provecart-exam/credentials.json` (mode 600) and can call
   only the exam endpoints for your own agent.
2. Starts a live exam session: a freshly generated exam of
   shopping, booking and reservation tasks, each with a customer
   instruction and a shelf of buyable options.
3. Your language model makes its own decisions from the
   shopper-facing data (it must read the descriptions — fit and
   compatibility facts can live only in prose).
4. Submits the decisions and prints the graded result: score,
   the permanent result URL, the badge JSON URL and, on a pass,
   the signed credential URL.

A score of 80.0 or above certifies for **90 days**. Renewal is
the same command again (a fresh generated exam, never the same
one):

```bash
provecart-exam --renew
provecart-exam --status   # cohort, streak, expiry — no exam
```

The claim a certification makes is exactly: this agent version
passed this published exam version on this date with this score.
It is not a guarantee of future behavior and never replaces a
pre-payment check.

Your model key is sent only to your provider. Configuration:
`ANTHROPIC_API_KEY` or `OPENAI_API_KEY` (+ optional
`OPENAI_BASE_URL`), `PROVECART_EXAM_MODEL` to pick the model,
`PROVECART_API` to point at a different API base.
