graph-engine-memory 0.6.1__tar.gz

graph_engine_memory-0.6.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SaltKing0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

graph_engine_memory-0.6.1/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: graph-engine-memory
+Version: 0.6.1
+Summary: Self-growing idea graph: Ingest → Embed → Suggest → Visualize. A generic engine for a persistent knowledge graph backed by your own private git repo (the 'brain').
+Author: SaltKing0
+License: MIT
+Project-URL: Homepage, https://github.com/SaltKing0/graph-engine
+Project-URL: Repository, https://github.com/SaltKing0/graph-engine
+Project-URL: Issues, https://github.com/SaltKing0/graph-engine/issues
+Project-URL: Changelog, https://github.com/SaltKing0/graph-engine/blob/main/CHANGELOG.md
+Project-URL: PyPI, https://pypi.org/project/graph-engine-memory/
+Keywords: knowledge-graph,memory,agent,embeddings,rag,zettelkasten
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Environment :: Web Environment
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi==0.141.1
+Requires-Dist: uvicorn[standard]==0.35.0
+Requires-Dist: httpx==0.28.1
+Requires-Dist: numpy==2.3.1; python_version < "3.14"
+Requires-Dist: numpy>=2.3.2; python_version >= "3.14"
+Provides-Extra: st
+Requires-Dist: sentence-transformers==5.0.0; extra == "st"
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.28; extra == "mcp"
+Requires-Dist: sse-starlette<3,>=1.6.1; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest==8.4.0; extra == "dev"
+Dynamic: license-file
+
+# GraphEngine 🕸️
+
+**A Git-backed knowledge graph for agents and humans.**
+
+Store knowledge as Markdown in your own private repository. GraphEngine adds
+search, relationships, memory maintenance and a web UI, with every change
+recorded in Git.
+
+![GraphEngine — demo brain in the web UI](docs/screenshot.png)
+
+- Search with embeddings and BM25; explain results and graph connections.
+- Extract entities and facts with source evidence and a review queue.
+- Consolidate observations, organize memory into tiers and learn from feedback.
+- Connect agents through the CLI, HTTP API or optional MCP server.
+- Keep separate graphs with optional role and node access control.
+
+## Quickstart
+
+Requires **Python 3.11+** and **Git**. These instructions use current `main`;
+published packages may have fewer features.
+
+```bash
+git clone https://github.com/SaltKing0/graph-engine.git
+cd graph-engine
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e ".[dev]"
+
+export IG_BRAIN_PATH="$PWD/demo-brain"
+export IDEAGRAPH_EMBEDDER=hash
+ig init --demo
+python -m uvicorn graph_engine.server:app --host 127.0.0.1 --port 8000
+```
+
+Open <http://localhost:8000>. The demo uses deterministic hash embeddings with
+no model download. For semantic search, install `python -m pip install -e ".[st]"`
+and set `IDEAGRAPH_EMBEDDER=st` before starting a fresh brain.
+
+On Windows, activate with `.venv\Scripts\Activate.ps1` and set environment
+variables using PowerShell's `$env:NAME="value"` syntax.
+
+For a released package, use `python -m pip install graph-engine-memory` in a virtual
+environment. Optional extras: `[st]` for semantic embeddings, `[mcp]` for MCP.
+
+Version 0.6.1 is the first PyPI release under the `graph-engine-memory` package name
+(previously `ideagraph-live`). Install it in a fresh virtual environment and
+point `IG_BRAIN_PATH` at your existing brain. The `ig` commands remain;
+Python imports and the uvicorn module now use `graph_engine` instead of
+`ideagraph`.
+
+## Everyday use
+
+```bash
+ig ingest "User prefers short answers" --source agent
+ig search "answer preferences"
+ig entities "Alice works at Acme." --dry-run --json
+ig pending
+ig accept <edge_id>
+ig explain <node_id> --query "answer preferences"
+ig dream                          # preview memory maintenance
+```
+
+For your own brain, set `IG_BRAIN_PATH` and run `ig init` without `--demo`.
+The default path is `~/graph-engine-brain`. Connect a private remote with
+`ig init --remote <url>`; Git mode commits changes and syncs with that remote.
+Use one writer process per brain.
+
+To connect an MCP client, install the MCP extra and run `ig mcp`.
+It is read-only by default; `ig mcp --write` enables remember, recall and forget.
+See the [MCP setup](docs/guide.md#mcp-server-ai-assistants) for client configuration.
+
+## Documentation
+
+- [CLI reference](docs/guide.md#cli) and [configuration](docs/guide.md#configuration)
+- [Entities and facts](docs/guide.md#extract-entities-and-facts)
+- [Memory lifecycle](docs/guide.md#memory-lifecycle-promotion-and-decay),
+  [storage tiers and feedback](docs/guide.md#storage-tiers-and-retrieval-feedback)
+- [Isolated graphs and access control](docs/guide.md#isolated-graphs-and-access-control)
+- [Known limitations](docs/guide.md#known-limitations)
+- [Changelog](CHANGELOG.md) and [contributing](CONTRIBUTING.md)
+
+The engine is public; your brain is a separate repository under your control.
+Extracted facts and heuristic relationships are claims to review, not verified truth.
+
+## Development
+
+```bash
+python -m pip install -e ".[dev,mcp]"
+python -m pytest tests/ -q
+```
+
+MIT — see [LICENSE](LICENSE).

graph_engine_memory-0.6.1/README.md

@@ -0,0 +1,92 @@
+# GraphEngine 🕸️
+
+**A Git-backed knowledge graph for agents and humans.**
+
+Store knowledge as Markdown in your own private repository. GraphEngine adds
+search, relationships, memory maintenance and a web UI, with every change
+recorded in Git.
+
+![GraphEngine — demo brain in the web UI](docs/screenshot.png)
+
+- Search with embeddings and BM25; explain results and graph connections.
+- Extract entities and facts with source evidence and a review queue.
+- Consolidate observations, organize memory into tiers and learn from feedback.
+- Connect agents through the CLI, HTTP API or optional MCP server.
+- Keep separate graphs with optional role and node access control.
+
+## Quickstart
+
+Requires **Python 3.11+** and **Git**. These instructions use current `main`;
+published packages may have fewer features.
+
+```bash
+git clone https://github.com/SaltKing0/graph-engine.git
+cd graph-engine
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e ".[dev]"
+
+export IG_BRAIN_PATH="$PWD/demo-brain"
+export IDEAGRAPH_EMBEDDER=hash
+ig init --demo
+python -m uvicorn graph_engine.server:app --host 127.0.0.1 --port 8000
+```
+
+Open <http://localhost:8000>. The demo uses deterministic hash embeddings with
+no model download. For semantic search, install `python -m pip install -e ".[st]"`
+and set `IDEAGRAPH_EMBEDDER=st` before starting a fresh brain.
+
+On Windows, activate with `.venv\Scripts\Activate.ps1` and set environment
+variables using PowerShell's `$env:NAME="value"` syntax.
+
+For a released package, use `python -m pip install graph-engine-memory` in a virtual
+environment. Optional extras: `[st]` for semantic embeddings, `[mcp]` for MCP.
+
+Version 0.6.1 is the first PyPI release under the `graph-engine-memory` package name
+(previously `ideagraph-live`). Install it in a fresh virtual environment and
+point `IG_BRAIN_PATH` at your existing brain. The `ig` commands remain;
+Python imports and the uvicorn module now use `graph_engine` instead of
+`ideagraph`.
+
+## Everyday use
+
+```bash
+ig ingest "User prefers short answers" --source agent
+ig search "answer preferences"
+ig entities "Alice works at Acme." --dry-run --json
+ig pending
+ig accept <edge_id>
+ig explain <node_id> --query "answer preferences"
+ig dream                          # preview memory maintenance
+```
+
+For your own brain, set `IG_BRAIN_PATH` and run `ig init` without `--demo`.
+The default path is `~/graph-engine-brain`. Connect a private remote with
+`ig init --remote <url>`; Git mode commits changes and syncs with that remote.
+Use one writer process per brain.
+
+To connect an MCP client, install the MCP extra and run `ig mcp`.
+It is read-only by default; `ig mcp --write` enables remember, recall and forget.
+See the [MCP setup](docs/guide.md#mcp-server-ai-assistants) for client configuration.
+
+## Documentation
+
+- [CLI reference](docs/guide.md#cli) and [configuration](docs/guide.md#configuration)
+- [Entities and facts](docs/guide.md#extract-entities-and-facts)
+- [Memory lifecycle](docs/guide.md#memory-lifecycle-promotion-and-decay),
+  [storage tiers and feedback](docs/guide.md#storage-tiers-and-retrieval-feedback)
+- [Isolated graphs and access control](docs/guide.md#isolated-graphs-and-access-control)
+- [Known limitations](docs/guide.md#known-limitations)
+- [Changelog](CHANGELOG.md) and [contributing](CONTRIBUTING.md)
+
+The engine is public; your brain is a separate repository under your control.
+Extracted facts and heuristic relationships are claims to review, not verified truth.
+
+## Development
+
+```bash
+python -m pip install -e ".[dev,mcp]"
+python -m pytest tests/ -q
+```
+
+MIT — see [LICENSE](LICENSE).

graph_engine_memory-0.6.1/graph_engine/__init__.py

@@ -0,0 +1 @@
+"""GraphEngine."""