graph-engine-memory 0.6.1__py3-none-any.whl

graph_engine_memory-0.6.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,53 @@
+graph_engine/__init__.py,sha256=io2Me22CNz6CiFM9RI94CfHXQCrpQrjjkjgFD2s5BM0,19
+graph_engine/__main__.py,sha256=R_6ZVg7Pn7O2h-wPs359CraDZk43VcSonAzG_nyOkc4,51237
+graph_engine/access.py,sha256=UnA2McEWiD6EW32fl4lCVcRNeiVM73sCqK85dOyIVUc,8936
+graph_engine/agent_memory.py,sha256=lYNwP50lmKpexvjvQIFbZss6zhlMlLeJi1BjKSYdjq8,4939
+graph_engine/brain.py,sha256=9nv7LjXFg_AGU4pnfQc7JR7Ys8YPp-DZU7G2JIDmubc,35499
+graph_engine/brain_engine.py,sha256=O1UcYaVKbyWp2Oohvl92yMiTaCm2BUaa23Qq54SZ9H8,28202
+graph_engine/communities.py,sha256=hes-ZrPA4DheEI9sytwWZGu8OPLwrO43nqrvfZVH6Vg,21091
+graph_engine/consolidation.py,sha256=mG80V-U91Wugg1HQw0qzGwGfTHup76aNsYF_nI2NkO8,8641
+graph_engine/context.py,sha256=BfF6MdC4vrrvYQRX5rHoYl44T5MyPmSA65hLtdEJI6Y,6855
+graph_engine/decay.py,sha256=T40Y5hkxILimyGlr97xkSPJXj_1KOs-87PkDvr86CCI,2264
+graph_engine/demo.py,sha256=hXPt4KTtlcsJmFkV5aXyZPs_w_WSmNcx6aHv3oZzdpU,8788
+graph_engine/dream.py,sha256=ZOylVWIE-NZaDndPSxmBTJvlgsqCNdu9BWbZqWCBnAM,19727
+graph_engine/embedder.py,sha256=X4_yvaqnCloBKjW9QYV2kJRGDZSyiPUEHae5V7-QYrw,3030
+graph_engine/engine.py,sha256=r9g5OeNir5yp9vy_znbHuWSorHSl3KSXrySLPr4RsHE,1781
+graph_engine/entities.py,sha256=gK6Jvocek7NqsaAxWAxB4T2FyGbQTl8Q6gG9xBPx1jM,20104
+graph_engine/evals.py,sha256=iXB-UUAbuJO5HTIJov1jubfSGwrBJBtdZHGNmIG3bZY,53343
+graph_engine/feedback.py,sha256=3dO0GNWfvyPZ2E8CMgw-KCMRXI-y4XHL9ZukX-RbcBU,6797
+graph_engine/gaps.py,sha256=VRV8ZoOKpmODruZaBsbE7oqv3zCBRjNcx6Mcve-mJKg,8721
+graph_engine/graph.py,sha256=GhNbirNx5ff7YBQeEpEon0Fbht32lmKW96V761HYGxA,4740
+graph_engine/hygiene.py,sha256=iy9stNX8I48fXPfLNVZqwem2UOmmmaL_bMqIkXsYR0E,7938
+graph_engine/inference.py,sha256=d46D2attuh0XoOP-123DjprwEUZ9iqau2fOO6vPKg-Q,11910
+graph_engine/intent.py,sha256=QrzYXhVu40MxNbP5KG-9RwNmSfJQItX6k7VGNsa3cqU,8973
+graph_engine/merge.py,sha256=w4CAx4SkTHPlI4nJKFVcdA3o7H2ihSKVgJT13ANOUBw,9285
+graph_engine/model.py,sha256=_wARULNEuSB1UhgNhzwsLa1JKxH8jooj2FbBK6l69gs,1488
+graph_engine/namespaces.py,sha256=6kkUpsOgi7OqqFViQr4_5SqzOzGVWKMfMb-OpVdcKF8,2497
+graph_engine/recall.py,sha256=aFDheLrbwM3vo3wrBZixG4DY9RZX90naPq1UhjqFGSc,6540
+graph_engine/report.py,sha256=DNAJvEmoBuRF4Qux7nmtmxA_0fUtRAgtcx-Dd3TAqdQ,16467
+graph_engine/reranker.py,sha256=gLRBpy0ftSyayOWSk5BiyZGo-sSYqn1W6gqmi0TzjqQ,3655
+graph_engine/retrieval.py,sha256=Mh-gBg5N1zuNtdJRP53FKOnU93Jb248LnjaJsHk68nc,14419
+graph_engine/review.py,sha256=QL4V_Q6O4kl7n2OIHBS_yif3463ZxmzqmxKa-mW_Tus,4256
+graph_engine/runtime.py,sha256=Vts4V6W4T-WY2hOogvl2hQ1PczyEzmDPG74EkamKLBA,3462
+graph_engine/server.py,sha256=xoRdlblz_R1ERMlYpaYz7rwFmgNmFvwh0eyZvcFEHgo,7865
+graph_engine/similarity.py,sha256=n_0g1wvcRbc1iFiuNNfTGXfbArcqFT0QNBlc97Kx-C8,1841
+graph_engine/store.py,sha256=6bR4o8zqIo12yYZ9KX6WMoZoZfL9mxTTn3S5omsPB44,2241
+graph_engine/suggester.py,sha256=OQQ-h0sP2dPo_1H0gVpvmb8AQwA4tuxjI0TcqpTJSAg,2032
+graph_engine/temporal.py,sha256=t50JtkHeIqDn_cJ7c0w_aGMMPrl_fVdvdiO7CljIQpE,7416
+graph_engine/tiers.py,sha256=VNCqWeVdRtQD8smMzGUkpoBuXROYEhVAbE87zImkqfs,5760
+graph_engine/mcp/__init__.py,sha256=jUT0aUlmvEZfrmA0TIao10NuLG3p-qpxGWlMnLZ6xkk,66
+graph_engine/mcp/format.py,sha256=yJz-7cOfu0rbIMiXWQEjCEuUQRzgTulkwpURfYuMuTc,2252
+graph_engine/mcp/server.py,sha256=mAJH8Xx-D_K_7DaYuWs-ADnEIKygzStbnBNDO_5Vtk0,17035
+graph_engine/mcp/agent/instructions.md,sha256=mKDEiULBU0GltvpzFJXb6bEKA7XzA9-go6j_rBaA3Mo,1587
+graph_engine/web/app.js,sha256=ppAXUrMdyj20LZxr3AghJvxTvSHWgwy8GS9rByVDYq0,31418
+graph_engine/web/index.html,sha256=85maFD8kf1bUbUirT3qbovUX2qN7k5z-ci-HGIWLfiQ,16827
+graph_engine/web/report.html,sha256=zPpSMHBmc_FCl4MTe6MPL1jq6zWoSlB_0llLklzW3JQ,1854
+graph_engine/web/report.js,sha256=PwN-Y1Uk55ASJcRwi2GUsPJM_6ASYtSnDiHajs7r0i8,1871
+graph_engine/web/review.html,sha256=gCQhPzy1X0WclF8FkekS2Qzj4Ug-7_g2dX1e27oFNyM,5717
+graph_engine/web/review.js,sha256=PWDoIUNiqDGRcJXIm6av2_vZ6kQ7lO3vR8F3T73MSrQ,8726
+graph_engine_memory-0.6.1.dist-info/licenses/LICENSE,sha256=jn5DTZjEHWVudlenBJ6fSb2OZuFctMRSfZFrdE-u-dE,1066
+graph_engine_memory-0.6.1.dist-info/METADATA,sha256=HaYM1cpyo-04Nof5cQw30KzWwU4rwileFlCrOn6P34o,5105
+graph_engine_memory-0.6.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+graph_engine_memory-0.6.1.dist-info/entry_points.txt,sha256=RnK_gnpj6P2pMt5Mrc3YGf2652GJRqOHM4QndUlRveQ,88
+graph_engine_memory-0.6.1.dist-info/top_level.txt,sha256=Bs0csPGrvqBCO_b7FiwDPInTj6gCDxqfWUVVXoXrLic,13
+graph_engine_memory-0.6.1.dist-info/RECORD,,

graph_engine_memory-0.6.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

graph_engine_memory-0.6.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ig = graph_engine.__main__:main
+ig-mcp = graph_engine.mcp.server:main

graph_engine_memory-0.6.1.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+graph_engine