Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions profile/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,21 @@

**HUMMBL is an open-source governance framework for multi-agent AI systems.** It provides delegation tokens, circuit breakers, kill switches, and append-only audit logging as Python-stdlib-only primitives -- no third-party runtime dependencies. Built for teams running production AI agent fleets who need deterministic safety controls, not probabilistic guardrails.

`550+ tests (unit · integration · property)` | `120 mental models` | `0 runtime deps` | `Python 3.11-3.14` | `pip install hummbl-governance` | `Production since 2024`
`1970 collected tests` | `120 mental models` | `0 runtime deps` | `Python 3.11-3.14` | `pip install hummbl-governance` | `Production since 2024`

---

### Projects
## Projects

| Project | What problem it solves | |
|---------|----------------------|---|
| **[hummbl-governance](https://github.com/hummbl-dev/hummbl-governance)** | Enforces agent permissions, cost budgets, and kill-switch authority in Python with 583 tests and zero runtime dependencies. `pip install hummbl-governance` | [![PyPI](https://img.shields.io/pypi/v/hummbl-governance)](https://pypi.org/project/hummbl-governance/) [![Python](https://img.shields.io/pypi/pyversions/hummbl-governance)](https://pypi.org/project/hummbl-governance/) [![License](https://img.shields.io/github/license/hummbl-dev/hummbl-governance)](https://github.com/hummbl-dev/hummbl-governance/blob/main/LICENSE) |
| **[hummbl-governance](https://github.com/hummbl-dev/hummbl-governance)** | Enforces agent permissions, cost budgets, and kill-switch authority in Python with 1970 collected tests and zero runtime dependencies. `pip install hummbl-governance` | [![PyPI](https://img.shields.io/pypi/v/hummbl-governance)](https://pypi.org/project/hummbl-governance/) [![Python](https://img.shields.io/pypi/pyversions/hummbl-governance)](https://pypi.org/project/hummbl-governance/) [![License](https://img.shields.io/github/license/hummbl-dev/hummbl-governance)](https://github.com/hummbl-dev/hummbl-governance/blob/main/LICENSE) |
| **[base120](https://github.com/hummbl-dev/base120)** | Gives AI agents 120 validated mental models for structured reasoning with operator algebra and contract validation CLI. | [![License](https://img.shields.io/github/license/hummbl-dev/base120)](https://github.com/hummbl-dev/base120/blob/main/LICENSE) |
| **[mcp-server](https://github.com/hummbl-dev/mcp-server)** | Exposes Base120 frameworks to Claude, ChatGPT, and other LLMs via Model Context Protocol. | [![License](https://img.shields.io/github/license/hummbl-dev/mcp-server)](https://github.com/hummbl-dev/mcp-server/blob/main/LICENSE) |
| **[hummbl-agent](https://github.com/hummbl-dev/hummbl-agent)** | Provides registry-first deterministic agent lifecycle management. | [![License](https://img.shields.io/github/license/hummbl-dev/hummbl-agent)](https://github.com/hummbl-dev/hummbl-agent/blob/main/LICENSE) |
| **[arbiter](https://github.com/hummbl-dev/arbiter)** | Agent-aware code quality scoring — cyclomatic complexity, dependency analysis, test coverage, governance compliance. Grades repos A through F with evidence-backed findings. | [![License](https://img.shields.io/github/license/hummbl-dev/arbiter)](https://github.com/hummbl-dev/arbiter/blob/main/LICENSE) |
| **[hummbl-skills](https://github.com/hummbl-dev/hummbl-skills)** | HUMMBL Agent Skills — canonical skill definitions, CI-validated SKILL.md files, skill creation templates, and cross-agent skill export tooling. | [![License](https://img.shields.io/github/license/hummbl-dev/hummbl-skills)](https://github.com/hummbl-dev/hummbl-skills/blob/main/LICENSE) |
| **[hummbl-transparency](https://github.com/hummbl-dev/hummbl-transparency)** | HUMMBL AI Transparency Registry — structured, versioned, evidence-backed vendor prompt auditing, model behavior documentation, and system prompt change tracking. | [![License](https://img.shields.io/github/license/hummbl-dev/hummbl-transparency)](https://github.com/hummbl-dev/hummbl-transparency/blob/main/LICENSE) |
| **hummbl-transparency** *(private repository)* | HUMMBL AI Transparency Registry — structured, versioned, evidence-backed vendor prompt auditing, model behavior documentation, and system prompt change tracking. | Private |
| **[governed-compression](https://github.com/hummbl-dev/governed-compression)** | Governed vector and KV-cache compression research — CPU reference, reproducible benchmarks, tuple-based experiment logging. | [![License](https://img.shields.io/github/license/hummbl-dev/governed-compression)](https://github.com/hummbl-dev/governed-compression/blob/main/LICENSE) |
| **[evidence-gate](https://github.com/hummbl-dev/evidence-gate)** | Pre-publish source-verification rule library for HUMMBL governance content. Stdlib-only TOML rules + fixture harness. | [![License](https://img.shields.io/github/license/hummbl-dev/evidence-gate)](https://github.com/hummbl-dev/evidence-gate/blob/main/LICENSE) |
| **[hummbl-bibliography](https://github.com/hummbl-dev/hummbl-bibliography)** | HUMMBL Bibliography — provenance corpus, BibTeX citations, and position papers for Base120, HCC, BKI, and AI governance research. | [![License](https://img.shields.io/github/license/hummbl-dev/hummbl-bibliography)](https://github.com/hummbl-dev/hummbl-bibliography/blob/main/LICENSE) |
Expand All @@ -25,7 +25,7 @@ Unlike LangChain and CrewAI (which focus on agent orchestration) or Microsoft's

---

### FAQ
## FAQ

**Q: What is HUMMBL?**
A: HUMMBL is an open-source Python framework for governing multi-agent AI systems. It provides delegation tokens (HMAC-SHA256 signed), circuit breakers, kill switches (4 modes), and append-only audit logging. It uses only Python stdlib -- zero third-party runtime dependencies. Install via `pip install hummbl-governance`.
Expand All @@ -37,7 +37,7 @@ A: Run `pip install hummbl-governance`. Requires Python 3.11 or newer. No additi
A: Base120 is a library of 120 validated mental models organized into 6 domains (Perspective, Inversion, Composition, Decomposition, Recursion, Systems). It includes an operator algebra for composing models and a contract validation CLI. AI agents use Base120 for structured reasoning via the HUMMBL MCP server.

**Q: How is HUMMBL different from LangChain or CrewAI?**
A: LangChain and CrewAI are agent orchestration frameworks. HUMMBL is a governance layer that sits alongside any orchestrator. It answers "what is this agent allowed to do?" not "how do I chain agents together." HUMMBL has zero runtime dependencies, uses deterministic controls (not probabilistic), and is tested with 550+ tests across the published libraries, covering unit tests for individual components, integration tests for multi-component orchestration, and property-based tests that verify determinism and canonical-form invariants.
A: LangChain and CrewAI are agent orchestration frameworks. HUMMBL is a governance layer that sits alongside any orchestrator. It answers "what is this agent allowed to do?" not "how do I chain agents together." HUMMBL has zero runtime dependencies, uses deterministic controls (not probabilistic), and is tested with 1970 collected tests across the published libraries, covering unit tests for individual components, integration tests for multi-component orchestration, and property-based tests that verify determinism and canonical-form invariants.

---

Expand Down
Loading