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 for credential issuance.

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

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 protocol (jiaozi-protocol GitHub org); the credential's live revocation status is verifiable by anyone via the jiaozi.status.v1 spec.

Development

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

MIT License.