Introducing heepx, an unofficial Python client

HeepX builds capability repositories: a written protocol plus a deterministic evaluation suite, meant to make an AI system better at exactly one thing — not a prompt, not a framework, not a product. Nine exist today: warrant, reasoning, verify, planning, memory, coding, security, coordination, synthesis.

heepx is a small, independent Python client for loading one of them — downloading it, verifying it against a content fingerprint, and handing it back as a typed value. It is not affiliated with or governed by the HeepX organization's HXS-1 standard.

pip install heepx
hx learn warrant

import heepx

warrant = heepx.learn("warrant")
print(warrant.name, warrant.version)

What it ships

• A frozen, six-function Python API: learn, search, info, list, verify, update.
• The hx CLI, a thin wrapper over the same six functions.
• A default registry (GitHubRegistry) pointed at the real HeepX organization — hx learn <name> fetches a real, published capability, pinned at its newest release tag, the way its own governance (decisions/0005) says a consumer should.
• Content-fingerprint verification, so a capability that's been tampered with or corrupted on disk is caught, not silently trusted.

What it isn't

It doesn't execute capabilities, and it doesn't talk to any model provider — that's a separate concern, layered on top of the Capability object it hands back. It also isn't proof that any of this works: the ecosystem's own honest status is one controlled benchmark, one small model, a placebo-controlled delta of +0.208 at p=0.125 (not significant), against a prompt-length cost significant at p=0.008. Promising and unproven, not settled.

Read the Quick Start or the architecture overview for how the client's pieces fit together, or workspace/CHARTER.md for what HeepX itself actually is.