hg_cpp

A clean-slate, C++-first implementation of the hgraph functional-reactive time-series runtime. The C++ runtime is the source of truth. Python provides wiring compatibility and supports Python-authored nodes running inside that runtime.

Python package

The C++-backed compatibility package is published under the hg_cpp distribution name:

python -m pip install hg_cpp

The distribution exposes the hgraph import package and the native _hgraph extension. Install it in an isolated environment rather than alongside the main hgraph distribution, since both provide the same Python import namespace. One wheel per supported platform covers CPython 3.12 and later through the CPython stable ABI. The supported Python and platform policy is recorded in docs/source/developer_guide/release_readiness.rst.

Build & test

cmake -S . -B build                 # configure (fmt + Catch2 fetched if absent)
cmake --build build -j              # build hgraph_core + tests
ctest --test-dir build --output-on-failure

Requires a C++23 compiler and CMake >= 3.25. Python/nanobind are not needed for the default build (bindings are opt-in via -DHGRAPH_BUILD_PYTHON_BINDINGS=ON).

Documentation

Sphinx docs live under docs/source (uv sync --extra docs, then uv run sphinx-build -W -b html docs/source docs/_build/html):

  • User guide — start at docs/source/user_guide/quick_start.rst, then the authoring/testing guides for nodes, graphs, and the eval_node harness.
  • Developer guide — the authoritative design records (docs/source/developer_guide/): architecture, data structures, wiring, nested graphs, mesh, services, error handling, operators, roadmap.

Contributing / AI sessions

  • AGENTS.md — canonical project direction: goals, build philosophy, source layout, dependency policy, git hygiene.
  • CLAUDE.md — the operational working guide: the enforced design-first workflow (docs change in the same commit as code), guardrails, architecture map, and current state.
  • The read-only ext/main tree is the canonical Python hgraph reference.

Project links

Data verified by PyPI on Aug 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.4.18)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for hhenson from gravatar.com hhenson

Credits

Author: Howard Henson

GitHub Statistics

Data verified by PyPI on Aug 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.12

Provides Extra

python test parity web sql snowflake kafka delta perspective dataframe docs dev

Tags

reactive graph forward propagating graph time series functional reactive programming c++

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hg_cpp-0.4.17.tar.gz (2.8 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

hg_cpp-0.4.17-cp312-abi3-win_amd64.whl (16.8 MB view details)

Uploaded CPython 3.12+Windows x86-64

hg_cpp-0.4.17-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (8.7 MB view details)

Uploaded CPython 3.12+manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

hg_cpp-0.4.17-cp312-abi3-macosx_15_0_arm64.whl (8.1 MB view details)

Uploaded CPython 3.12+macOS 15.0+ ARM64

File details

Details for the file hg_cpp-0.4.17.tar.gz.

File metadata

  • Download URL: hg_cpp-0.4.17.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hg_cpp-0.4.17.tar.gz
Algorithm Hash digest
SHA256 3d8d10ae395d1ab27ed45bc605451ff368fb459be1d7f4e9359573d2ee7e1748
MD5 c6468bf60e7f0294251b40a0159d22cb
BLAKE2b-256 38e7931a910bbce24fd0b2b8d5b64ef24de96f73b8b88571d3cc57329ac88820

See more details on using hashes here.

Provenance

The following attestation bundles were made for hg_cpp-0.4.17.tar.gz:

Publisher: build.yml on hhenson/hg_cpp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hg_cpp-0.4.17-cp312-abi3-win_amd64.whl.

File metadata

  • Download URL: hg_cpp-0.4.17-cp312-abi3-win_amd64.whl
  • Upload date:
  • Size: 16.8 MB
  • Tags: CPython 3.12+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hg_cpp-0.4.17-cp312-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 23b3b6467459f102f22e1cfe4a453dccfda92f099ca593ee5617f12fab9221a8
MD5 08b09331e4fb22cee3e3c6313f3b0aec
BLAKE2b-256 b22d176dbe68d2072bd14c595b831277860f85ad61942addcbdadccc4bb25dc0

See more details on using hashes here.

Provenance

The following attestation bundles were made for hg_cpp-0.4.17-cp312-abi3-win_amd64.whl:

Publisher: build.yml on hhenson/hg_cpp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hg_cpp-0.4.17-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for hg_cpp-0.4.17-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 13dd16449e0549194748f085a03609968c185d10f556ee2c3bcf3e5d5b82e236
MD5 b5ef570c03f8a1d4934a448295e48fe0
BLAKE2b-256 9304cd90dcb103e164c4075d39c93615d37c0d1e64f8ac1a6950013337bdcded

See more details on using hashes here.

Provenance

The following attestation bundles were made for hg_cpp-0.4.17-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build.yml on hhenson/hg_cpp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hg_cpp-0.4.17-cp312-abi3-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for hg_cpp-0.4.17-cp312-abi3-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 68aed9cbb94b6cbb5194078f35cfa37b580a7fc9d07bf7dfe6fb36bf3955bfcc
MD5 a0496ca64482a8a14eeb80d55759b1ec
BLAKE2b-256 aa041c1bf7508ca96d27f7b7b2199b5b22e8085cfb3759ccb2ed2c9937959cb3

See more details on using hashes here.

Provenance

The following attestation bundles were made for hg_cpp-0.4.17-cp312-abi3-macosx_15_0_arm64.whl:

Publisher: build.yml on hhenson/hg_cpp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.4.18

4 files

This release

0.4.17 This release

4 files

0.4.16

4 files

0.4.15

4 files

0.4.14

4 files

0.4.13

4 files

0.4.12

4 files

0.4.11

4 files

0.4.10

4 files

0.4.9

4 files

0.4.8

4 files

0.4.7

4 files

0.4.6

4 files

0.4.5

4 files

0.4.4

4 files

0.4.3

4 files

0.4.2

4 files

0.4.1

4 files

0.4.0

4 files

Pre-release

0.4.0rc2

4 files

Pre-release

0.4.0rc1

4 files

0.3.3

4 files

0.3.2

4 files

0.3.1

4 files

0.3.0

4 files

0.2.0

4 files

0.1.4

4 files

0.1.3

4 files

0.1.2

4 files

0.1.1

4 files

0.1.0

4 files

0.0.5

6 files

0.0.4

4 files

0.0.3

3 files

0.0.2

3 files

0.0.1

3 files

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