hummbl
Structured reasoning framework for AI agents.
hummbl turns plans, hypotheses, observations, evaluations, decisions, and reflections into durable, inspectable artifacts. It provides reasoning primitives, protocols (scientific method, structured tool use), capture from existing artifacts or live runtime hooks, planning, local analysis, scoring, and visualization.
Python 3.10+, zero runtime dependencies (stdlib-only).
Install
pip install hummbl
For development:
git clone https://github.com/hummbl-io/oss.git
cd oss/packages/hummbl
pip install -e ".[test]"
No runtime dependencies are required. The test extra installs pytest>=9,<10.
Usage
hummbl provides core modules for reasoning capture and analysis:
reasoning.py— reasoning primitivesprotocols.py— scientific method and structured tool use protocolsplanner.py— planning primitivescapture.py— capture from existing artifacts or live runtime hooksanalyzer.py— local analysis of reasoning tracesscoring.py— scoring reasoning artifactsvisualize.py— visualization of reasoning tracescli.py— command-line interfacehummbl_tuples/— typed tuple primitives for contracts, delegation, evidence, and attestation
Reasoning traces are stored in traces/. Documentation (PRD, evals, roadmap, repo map) lives in docs/.
Testing
pytest
The test suite covers protocols, reasoning, scoring, and tool-use capture (tests/test_protocols.py, test_reasoning.py, test_scoring.py, test_tool_use_capture.py).
License
Apache License 2.0. See LICENSE.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hummbl-0.1.0.tar.gz.
File metadata
- Download URL: hummbl-0.1.0.tar.gz
- Upload date:
- Size: 46.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
062b4adf19a783c43c119a5c8fbe1cb06bf74c035766ecaed26537800a77c0d3
|
|
| MD5 |
c089f3efd8885ed9c775dcea9f27b204
|
|
| BLAKE2b-256 |
a01371b1caba08ffa5b81b0a6259fb2eaae907fa043bb9b6f7f2598d3e18251a
|
Provenance
The following attestation bundles were made for hummbl-0.1.0.tar.gz:
Publisher:
publish-pypi.yml on hummbl-io/oss
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hummbl-0.1.0.tar.gz -
Subject digest:
062b4adf19a783c43c119a5c8fbe1cb06bf74c035766ecaed26537800a77c0d3 - Sigstore transparency entry: 2582650346
- Sigstore integration time:
-
Permalink:
hummbl-io/oss@b1b05813832d14185bba12284dd8a6cede2f19c3 -
Branch / Tag:
refs/tags/hummbl/v0.1.0 - Owner: https://github.com/hummbl-io
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@b1b05813832d14185bba12284dd8a6cede2f19c3 -
Trigger Event:
push
-
Statement type:
File details
Details for the file hummbl-0.1.0-py3-none-any.whl.
File metadata
- Download URL: hummbl-0.1.0-py3-none-any.whl
- Upload date:
- Size: 46.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d97ca47ff246c3a4a0028c6a3edefe5ba960b3af352a291bc50436c86197f68
|
|
| MD5 |
abef595647c460bc3eaa633199604ae1
|
|
| BLAKE2b-256 |
53b02b6af6dfee27dc10c123786b85fa55078c0d66c27e5cc0f0e5547c060cb7
|
Provenance
The following attestation bundles were made for hummbl-0.1.0-py3-none-any.whl:
Publisher:
publish-pypi.yml on hummbl-io/oss
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hummbl-0.1.0-py3-none-any.whl -
Subject digest:
2d97ca47ff246c3a4a0028c6a3edefe5ba960b3af352a291bc50436c86197f68 - Sigstore transparency entry: 2582650357
- Sigstore integration time:
-
Permalink:
hummbl-io/oss@b1b05813832d14185bba12284dd8a6cede2f19c3 -
Branch / Tag:
refs/tags/hummbl/v0.1.0 - Owner: https://github.com/hummbl-io
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@b1b05813832d14185bba12284dd8a6cede2f19c3 -
Trigger Event:
push
-
Statement type:
