Metadata-Version: 2.4
Name: jiaozi-validator
Version: 0.3.0
Summary: Local AI-agent health check CLI - produces a jiaozi.attest.v1 summary and submits it for JIAOZI credential issuance
Author: Jiaozi Protocol contributors
License: MIT
Project-URL: Homepage, https://www.jiaozi.io/integrate
Project-URL: Documentation, https://www.jiaozi.io/docs
Project-URL: Source, https://github.com/jiaozi-protocol/jiaozi-app
Keywords: ai-agent,identity,attestation,did,jiaozi-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

# jiaozi-validator

Local health-check CLI for AI agents. Scans your agent directory, computes a
software gene hash, and produces a `jiaozi.attest.v1` summary — optionally
submitting it to [Jiaozi Cert](https://www.jiaozi.io) for certificate issuance.

Your code never leaves your machine: only hashes and check results are
submitted.

```bash
pip install jiaozi-validator

# Print the attestation summary only (nothing is sent anywhere)
jiaozi-validator --agent-name MyAgent --path ./my-agent --dry-run

# Submit for issuance (requires an API key)
export JIAOZI_API_KEY=your-key
jiaozi-validator --agent-name MyAgent --path ./my-agent \
  --api-url https://www.jiaozi.io/api/verify
```

China deployment: use `--api-url https://www.jiaozi.tech/api/verify`.

## What it checks

- Software gene hash (deterministic digest of your agent's code)
- Secret-leak scan (common credential patterns)
- Structure and metadata sanity

The output schema `jiaozi.attest.v1` is part of the open
[Jiaozi Protocol](https://github.com/jiaozi-protocol); the certificate's live
revocation status is verifiable by anyone via the
[`jiaozi.status.v1`](https://github.com/jiaozi-protocol/status-v1) spec.

## Development

```bash
cd packages/validator
python3 -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
```

MIT License.
