Skip to main content

Python client for the Hound Tag protocol on X1 — verifiable identity and tamper-evident memory for AI agents

Project description

Hound Tag

Verifiable identity and tamper-evident memory for AI agents on X1.

houndtag is the Python client for the Hound Tag protocol. It hashes your agent's memory into a deterministic fingerprint and anchors it on-chain as a sequence-numbered checkpoint — so anyone can prove what your agent knew, and when, without a single private byte ever leaving your machine. The chain stores proof, never content.

Install

pip install houndtag

Register your agent

Registration happens in the browser with a connected wallet — no keypair files to wrangle:

houndtag.xyz/register

Claim a globally unique, non-transferable name for your agent (one-time 2 XNT). Then use the CLI below to checkpoint and verify its memory.

Checkpoint memory

Point the client at your agent's memory directory. It hashes the current state, derives the next sequence number, and anchors the fingerprint on-chain.

# Preview — build the manifest, print the root hash and next seq, send nothing.
houndtag checkpoint <name> --memory ./memory --dry-run

# Anchor it — the owner keypair signs; 0.01 XNT per checkpoint.
houndtag checkpoint <name> --memory ./memory --keypair ~/.config/solana/id.json

# Hash only matching files (repeatable), and skip if unchanged since last time.
houndtag checkpoint <name> --memory ./memory --include "*.md" \
  --keypair ~/.config/solana/id.json --skip-unchanged

Verify memory

Recompute a checkpoint from its local archive and compare it to the on-chain record. Permissionless and free — anyone can run it.

houndtag verify <name> --seq 3

Prints MATCH (exit 0) or MISMATCH (exit 2).

Agent status

houndtag status <name>

Fees

Action Fee
Register 2 XNT (once)
Checkpoint 0.01 XNT
Verify Free

Protocol


MIT © 2026 Echo Hound Labs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

houndtag-0.1.0.tar.gz (15.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

houndtag-0.1.0-py3-none-any.whl (16.8 kB view details)

Uploaded Python 3

File details

Details for the file houndtag-0.1.0.tar.gz.

File metadata

  • Download URL: houndtag-0.1.0.tar.gz
  • Upload date:
  • Size: 15.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for houndtag-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ea5655d81089ab6e9151ad24d123ef3dcea03915b5ae115e8fd4aa6274bb32b6
MD5 e04bc87452497c2c40b9740d4ed89ecf
BLAKE2b-256 264dd475e40aa1b397770d231badaf3aee86b547f47ba41ff57ab25cdc6d8070

See more details on using hashes here.

File details

Details for the file houndtag-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: houndtag-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 16.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for houndtag-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9b6de2c32578070d8275f24aaae82d44ced6260e5fa42cf4d7652a6038d5d6ba
MD5 b6cab3553f6880dac3118b2ad7f970fd
BLAKE2b-256 3016a74063289ba848a61b7ebc3b5a714d7a0b205cb25b9f0751bd7df9f55a11

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page