Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

buhito

Logo

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:

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 features
  • src/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.

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)

Source distribution for buhito 0.0.1a2
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)

Table of built distributions (wheels) for buhito 0.0.1a2
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page