Skip to main content

Pre-alpha skeleton for Daedalus Context Graph, a reusable context graph kernel for AI agents and context engineering.

Project description

Daedalus Context Graph

Pre-alpha skeleton for Daedalus Context Graph, a reusable context graph kernel for AI agents and context engineering.

Daedalus Context Graph is a small, reusable kernel for building context graphs: scoped context cores, typed nodes and edges, provenance, decision traces, retrieval policies, and adapter boundaries. It is designed to stay useful outside Hermes while providing a clean path for a Hermes Agent memory-provider adapter.

Maintained by Dr. Mani Saint-Victor / BionicButterfly13: BionicButterfly.me.

Status

This package is pre-alpha. The code is MIT licensed, but the repository remains publicly visible once the initial skeleton is pushed.

This initial alpha exists to reserve the public package name and make the kernel installable while the API remains explicitly pre-alpha.

Install

Install the current skeleton from PyPI after the first alpha upload:

python -m pip install daedalus-context-graph

For GitHub-based development:

git clone https://github.com/bionicbutterfly13/daedalus-context-graph.git
cd daedalus-context-graph
python -m pip install -e ".[dev]"
pytest -q

Context Engineering Focus

The package is aimed at the current context-engineering wave: portable context cores, provenance-aware graph memory, decision traces, retrieval policies, and adapter surfaces for agent runtimes.

Package Strategy

The public package is the kernel. Hermes integration stays thin and optional:

  • General Python users install daedalus-context-graph for the context graph kernel.
  • Hermes users install a Hermes plugin/provider that depends on the kernel.

Current Skeleton

Implemented now:

  • DecisionTrace
  • ContextGraphStore protocol
  • EntityRef
  • ArtifactRef
  • EvidenceStandard
  • WorkflowVersion
  • InMemoryDaedalusGraph
  • Basic precedent search filters
  • JSON export surface

Planned:

  • Context core schema and namespace model.
  • Neo4j-backed store.
  • Ontology and active metadata layer.
  • Governed retrieval and access policy.
  • MCP server.
  • Hermes adapter/provider.
  • PyPI release workflow.

API reference: docs/API.md.

Contribution guide: CONTRIBUTING.md.

Local Checks

cd daedalus-context-graph
PYTHONPATH=src pytest -q
python -m compileall src
python -m build --sdist --wheel
python -m twine check dist/*

Project details


Download files

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

Source Distribution

daedalus_context_graph-0.1.0a0.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

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

daedalus_context_graph-0.1.0a0-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file daedalus_context_graph-0.1.0a0.tar.gz.

File metadata

  • Download URL: daedalus_context_graph-0.1.0a0.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for daedalus_context_graph-0.1.0a0.tar.gz
Algorithm Hash digest
SHA256 775d0422b6ff3e07e1c949c2499bbfc094032f9d900a8c73e9bfdcd74fa12d97
MD5 8df2ade104ca17052dc9a25886e34efd
BLAKE2b-256 8ba1770f87493311543d5d7b86c81095e0c42135004cbd4d07e637133ac18803

See more details on using hashes here.

Provenance

The following attestation bundles were made for daedalus_context_graph-0.1.0a0.tar.gz:

Publisher: publish.yml on bionicbutterfly13/daedalus-context-graph

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

File details

Details for the file daedalus_context_graph-0.1.0a0-py3-none-any.whl.

File metadata

File hashes

Hashes for daedalus_context_graph-0.1.0a0-py3-none-any.whl
Algorithm Hash digest
SHA256 9564e171dea9986ed1f24753696f0379aae32954b88e9c38a50cc2d4fe725f3d
MD5 da1e2c95fc32cb32974c3250265959e4
BLAKE2b-256 ec66f038b41fde0ef2cf0eb157fab2ddae05f7264653a88cba07edd5c53cbac6

See more details on using hashes here.

Provenance

The following attestation bundles were made for daedalus_context_graph-0.1.0a0-py3-none-any.whl:

Publisher: publish.yml on bionicbutterfly13/daedalus-context-graph

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page