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).
First-party extensions
First-party extensions are co-developed in extensions/ but remain separate
native and Python distributions. Kafka is built in-tree for development with
-DHGRAPH_BUILD_KAFKA_EXTENSION=ON, or independently from
extensions/kafka/ against an installed hgraph SDK. Its wheel is selected
from the uv workspace after making that matching SDK discoverable:
CMAKE_PREFIX_PATH=/path/to/hgraph/sdk \
uv build --wheel --package hgraph-kafka --python 3.12
The core build does not enable the extension by default and does not acquire a Kafka or librdkafka dependency.
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 theeval_nodeharness. - 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/maintree is the canonical Pythonhgraphreference.
1 maintainer
Metadata
1 maintainer
Release files for hg-cpp 0.4.18
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 | |
|---|---|---|---|---|
| hg_cpp-0.4.18.tar.gz | 2.9 MB | With provenance | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hg_cpp-0.4.18-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| hg_cpp-0.4.18-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| hg_cpp-0.4.18-cp312-abi3-macosx_15_0_arm64.whl | CPython 3.12 | abi3 | macOS 15.0+ ARM64 | Details |
Total release size: 36.0 MB
Release files / hg_cpp-0.4.18.tar.gz
| Download URL | hg_cpp-0.4.18.tar.gz |
|---|---|
| Size | 2.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8202f456f454e71bfeb948e6de7ebcd89bf26ae8fd2ff872e483f05444a9d9d9
|
|
BLAKE2b-256 checksum How to use checksums |
1b15e3316c190468cdd7a83f9105d2b577a57642229c31f66ebb56ce65be5f7c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 8, 2026.
Transparency logRelease files / hg_cpp-0.4.18-cp312-abi3-win_amd64.whl
| Download URL | hg_cpp-0.4.18-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 16.8 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a6a4f8ce0d328fb3b57d6c1c65023dae15fdd857d0496111b30bec6782c7706c
|
|
BLAKE2b-256 checksum How to use checksums |
81066fa44f32cc24a8ee6b448003487c9b269a50c073cd245ee99b11c333f82c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 8, 2026.
Transparency logRelease files / hg_cpp-0.4.18-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | hg_cpp-0.4.18-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 8.4 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
80c26eabd866b9da9b58eda644394816107299ec84c47d2cb617c91eb4a6fa27
|
|
BLAKE2b-256 checksum How to use checksums |
3e236ba5df60fc5d742b70b5e45e5a528edf21516c958ec0688a73624bb3aa0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 8, 2026.
Transparency logRelease files / hg_cpp-0.4.18-cp312-abi3-macosx_15_0_arm64.whl
| Download URL | hg_cpp-0.4.18-cp312-abi3-macosx_15_0_arm64.whl |
|---|---|
| Size | 8.0 MB |
| Tags | CPython 3.12 abi3 macOS 15.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
04b7b6809d1ee4ec1198184e1ac9ac3b47760de8e001be6433ab891a5df4eb2d
|
|
BLAKE2b-256 checksum How to use checksums |
769b07e76eb2a8b1d8847bc1fc26efcf123eac13d96c41bbbddb3fc0d44c51a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 8, 2026.
Transparency logSecurity for hg-cpp 0.4.18
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
All 4 files in this release have been uploaded with provenance metadata.
Attestation for hg_cpp-0.4.18.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 Aug 8, 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.
