This release is a pre-release and may not be stable for production use.
buhito
buhito is a Python library for enumerating graphlets and analyzing graphlet-based features from graphs.
Installation
git clone https://github.com/lanl/buhito.git
cd buhito
uv sync --all-extras
Quick Start
Enumerate graphlets with BFS
import networkx as nx
from buhito import generate_subgraphs_breadthwise
G = nx.petersen_graph()
nx.set_node_attributes(G, {n: "node" for n in G.nodes}, "node_label")
nx.set_edge_attributes(G, {e: "1" for e in G.edges}, "edge_label")
fp, bitinfo = generate_subgraphs_breadthwise(
G,
depth=4,
return_nodewise=False,
full_hash=True,
node_key="node_label",
edge_key="edge_label"
)
print("Graphlet fingerprint length:", len(fp))
Enumerate graphlets with DFS
from buhito import generate_subgraphs_depthwise
subsets, counts = generate_subgraphs_depthwise(G, maxlen=4)
print("Found graphlet subsets:", len(subsets))
Examples
Available example scripts:
examples/plotting_example.py— visualize graphlets from the Petersen graph- Reddit graph classification and enumeration benchmark
From the repository root:
uv run python examples/reddit_example/reddit_graphlets_example.py --data-root path/to/data_root
uv run python examples/reddit_example/reddit_individual_graphs_benchmark.py path/to/graph_pickles
Buhito provides general graph algorithms and has no MinervaChem or RDKit dependency.
Chemical conversion and the QM9 benchmark live in MinervaChem, which depends on
Buhito. The SMILES converter is now minervachem.converters.smiles_to_nx.
See package boundaries and migration notes and local/HPC demo runners.
Testing
pytest tests/
Package structure
src/buhito/— core featuressrc/buhito/plotting.py— graphlet visualization helpers
Authors
- Yulia Pimonova (LANL)
- Nicholas Lubbers (LANL)
- Nathan Lemons (LANL)
- Pieter Swart (LANL)
Citation
If you use buhito in your work, please cite this repository. A publication citation is coming.
Copyright and licensing
buhito is released under the BSD-3 License. See LICENSE.txt for the full license.
The copyright to buhito is owned by Triad National Security, LLC
and is released for open source use as project number O5043.
© 2026. Triad National Security, LLC. All rights reserved. This program was produced under U.S. Government contract 89233218CNA000001 for Los Alamos National Laboratory (LANL), which is operated by Triad National Security, LLC for the U.S. Department of Energy/National Nuclear Security Administration. All rights in the program are. reserved by Triad National Security, LLC, and the U.S. Department of Energy/National Nuclear Security Administration. The Government is granted for itself and others acting on its behalf a nonexclusive, paid-up, irrevocable worldwide license in this material to reproduce, prepare. derivative works, distribute copies to the public, perform publicly and display publicly, and to permit. others to do so.
Metadata
Release files for buhito 0.0.1a2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| buhito-0.0.1a2.tar.gz | 910.4 kB | With provenance | Details for buhito-0.0.1a2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| buhito-0.0.1a2-py3-none-any.whl | Python 3 | none | any | Details for buhito-0.0.1a2-py3-none-any.whl |
Total release size: 955.8 kB
Release files / buhito-0.0.1a2.tar.gz
| Download URL | buhito-0.0.1a2.tar.gz |
|---|---|
| Size | 910.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cf85eb49c133eeb73b8d06763df582e0d1160f7ec15dd0dd524c29407492a890
|
|
BLAKE2b-256 checksum How to use checksums |
1edf41679005aed2c387ad243381246392a57a292f291b50b48f384955cc4f2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logRelease files / buhito-0.0.1a2-py3-none-any.whl
| Download URL | buhito-0.0.1a2-py3-none-any.whl |
|---|---|
| Size | 45.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3c68d353b1a9aaf405c53a871dcdc2f762dbfe3d02490046dbf714fdbc9f388a
|
|
BLAKE2b-256 checksum How to use checksums |
708f9950ee5fa5460c66f42f4c37cfde8dcaf05d1411c02d92b2c3b0fba2f176
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logSecurity for buhito 0.0.1a2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for buhito-0.0.1a2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.