HMG — Agent Memory That Actually Works

Holographic Memory Graph — branch-aware, auditable, governable long-term memory kernel for coding agents.
Store decisions, trace corrections, govern knowledge. One tool call, complete answers.

🌐 Docs · 📦 Releases · 🏠 Website · 🚀 Quick Start

Quick Start

# Install (Linux / macOS)
curl -fsSL https://github.com/HMG-AI/HMG-public/releases/latest/download/install.sh | sh

# Initialize + start
hmg init -g
hmg daemon start

# Install (Windows PowerShell)
irm https://github.com/HMG-AI/HMG-public/releases/latest/download/install.ps1 | iex

# Initialize + start
hmg init -g
hmg daemon start

# Store your first memory
curl -s -X POST http://127.0.0.1:3000/api/memorize \
  -H 'Content-Type: application/json' \
  -d '{"content": "My first HMG memory!"}'

# Verify everything works
hmg doctor

Agent Memory Loop

capture → canonicalize → recall → correct → govern → consolidate → brief next session

Every coding agent session becomes context for the next. Decisions persist. Corrections leave history. Governance controls what gets remembered.

# Store a decision
memory_memorize(content="Use Rust for performance-critical paths", source="ADR-001")

# Next session: agent gets full context
memory_agent_brief(domain_pack_id="software-engineering")
# → scope, status, decisions, risks, next steps

# Correct stale knowledge
memory_correct(target_atom="01ABC...", action="replace", new_content="Use Rust + WASM")

# Govern sensitive data
memory_govern(target_atom="01DEF...", action="seal", reason="contains API key")

Editions

Single binary, runtime edition detection. No reinstall needed. Upgrade with hmg license apply <key>.

Agent Adapters

SDKs

# Python
pip install hmg-sdk

import hmg
client = hmg.HmgClient()
client.memorize("key decision: use Rust for perf")

# TypeScript
npm install @hmg_ai/sdk-ts

import { HmgClient } from "@hmg_ai/sdk-ts";
const client = new HmgClient();
await client.memorize({ content: "decision noted" });

Open Standard + Free Community Binary + Proprietary Memory Intelligence Engine

This repository contains the public artifacts for HMG:

• Protocol: protocol/ — hmg-protocol (Apache-2.0) standalone crate
• MCP Schemas: mcp/schemas/ — tool definitions
• OpenAPI: openapi/ — HTTP API spec
• SDKs: sdk-python/, sdk-ts/
• Certification: certification/ — conformance tests
• Docs: docs/ — multilingual documentation
• Installers: scripts/ — install.sh, install.ps1

The core memory engine is proprietary. This repository exists so developers can install, integrate, verify, and implement compatible protocols.

Documentation

Links

• Website: hmg1ai.com
• Docs: hmg-ai.github.io/HMG-public
• Releases: GitHub Releases
• Issues: GitHub Issues
• Security: GitHub Security
• Contributing: CONTRIBUTING.md

License

• Protocol & SDK artifacts: Apache-2.0
• Community Edition binary: LICENSE-COMMUNITY (free use, no redistribution)