OPEN SOURCE · STDLIB-ONLY · APACHE 2.0

Governance primitives
for AI-native teams

Delegation tokens, governance buses, kill switches, and circuit breakers. As Python packages. Import from PyPI. Run anywhere — including air-gapped environments. Zero external dependencies.

hummbl-governance
$ pip install hummbl-governance
15,600+ Platform Tests
25 Modules
0 Runtime Deps
120 Mental Models
< 50ms API Latency
Published on PyPI · Open Source on GitHub · Enterprise Consulting Available

The Governance Tuple

Every governed AI decision produces a triple: CONTRACT (what was authorized), DCT (who authorized it, cryptographically signed), and EVIDENCE (what actually happened). This is the atomic record that makes AI governance auditable.

CONTRACT
Permitted operations, resources, caveats, expiry
×
DCT
HMAC-signed delegation binding issuer → subject
×
EVIDENCE
Actual operations, resources accessed, cost, output
governance_tuple.py
from hummbl_governance import DelegationTokenManager, BusWriter, CostGovernor

# CONTRACT: define what the agent may do
contract = {
    "ops_allowed": ["read", "summarize"],
    "resources": ["docs/*"],
    "expiry": "2026-12-31T23:59:59Z"
}

# DCT: cryptographically bind the delegation
dtm = DelegationTokenManager()
token = dtm.issue(
    issuer="orchestrator",
    subject="summarizer-agent",
    operations=contract["ops_allowed"],
    resources=contract["resources"]
)

# EVIDENCE: audit what actually happened
bus = BusWriter("governance.jsonl")
bus.append(agent="summarizer-agent", action="read", resource="docs/report.md")
bus.append(agent="summarizer-agent", action="summarize", resource="docs/report.md")

Cognitive Layer: Base120 Mental Models

The reasoning substrate that operates over governance primitives. 120 validated mental models across 6 transformation types.

P
Perspective
Frame and anchor viewpoint. Change how you see the problem.
IN
Inversion
Flip to see what avoiding failure reveals. Think backwards.
CO
Composition
Combine for emergent properties. Build complexity from simplicity.
DE
Decomposition
Break complexity down. Understand the parts.
RE
Recursion
Apply patterns at multiple scales. Iterate and refine.
SY
Systems
Understand governing rules. See the meta-patterns.
Need governance for your agents?
Free Readiness Assessment
30-minute call. I'll review your agent architecture against EU AI Act Annex III requirements and tell you where the gaps are.
Learn More →

Try It Now

Describe a problem you're facing and get recommended mental models instantly. No signup required.

Recommended Models

Claude Desktop Setup

Install the MCP server to give Claude direct access to all 120 models.

Step 1: Install

terminal
$ npm install -g @hummbl/mcp-server

Step 2: Configure

Add to claude_desktop_config.json

claude_desktop_config.json
{
  "mcpServers": {
    "hummbl": {
      "command": "npx",
      "args": ["@hummbl/mcp-server"]
    }
  }
}

Step 3: Available Tools

Step 4: Available Resources

Step 5: Available Prompts

Use Cases

HUMMBL provides structured reasoning infrastructure for AI systems. Use it via API, Claude Desktop MCP integration, or direct framework integration:

Agent Frameworks

LangChain, CrewAI, AutoGPT, Semantic Kernel - invoke mental models programmatically to guide agent reasoning.

Claude Desktop

MCP server gives Claude direct access to all 120 models. Search, retrieve, and apply cognitive frameworks in real-time.

Custom Applications

REST API for decision support tools, prompt engineering systems, or reasoning-enhanced workflows. No framework required.

Prompt Engineering

Retrieve relevant mental models based on problem context, then inject into system prompts for better LLM outputs.

Knowledge Systems

Build cognitive enhancement tools, decision support systems, or structured thinking applications on top of Base120.

Research & Education

Access validated mental models programmatically for cognitive science research, educational tools, or training systems.

Book a call to see how Base120 fits your use case.