feat(sdk): add longmemory-sdk Python HTTP client and openmemory-py bridge

- zero-dependency sync/async Python client for the self-hosted API
- openmemory-py 2.0 forwards imports to longmemory-sdk
- PyPI publish jobs via trusted publishing in publish-sdks workflow
- changelog, migration, and readme updates for package rename

Author: nullure

.github/banner.png

@@ -58,6 +58,60 @@ jobs:
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+    npm-legacy-bridge:
+        needs: [validate, npm]
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 22
+                  registry-url: https://registry.npmjs.org
+            - run: npm publish ./packages/openmemory-js --access public --provenance
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+            - run: npm deprecate "openmemory-js@<2.0.0" "Package renamed to longmemory. Install longmemory instead."
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+    pypi-longmemory-sdk:
+        needs: validate
+        runs-on: ubuntu-latest
+        environment:
+            name: pypi-longmemory-sdk
+            url: https://pypi.org/p/longmemory-sdk
+        permissions:
+            id-token: write
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-python@v5
+              with:
+                  python-version: '3.13'
+            - run: python -m pip install build
+            - run: python -m build packages/longmemory-py
+            - uses: pypa/gh-action-pypi-publish@release/v1
+              with:
+                  packages-dir: packages/longmemory-py/dist
+
+    pypi-legacy-bridge:
+        needs: [validate, pypi-longmemory-sdk]
+        runs-on: ubuntu-latest
+        environment:
+            name: pypi-openmemory-py
+            url: https://pypi.org/p/openmemory-py
+        permissions:
+            id-token: write
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-python@v5
+              with:
+                  python-version: '3.13'
+            - run: python -m pip install build
+            - run: python -m build packages/openmemory-py
+            - uses: pypa/gh-action-pypi-publish@release/v1
+              with:
+                  packages-dir: packages/openmemory-py/dist
+
     n8n:
         needs: validate
         runs-on: ubuntu-latest

.github/logo.png

@@ -14,6 +14,8 @@ node_modules/
 dist/
 __pycache__/
 *.py[cod]
+*.egg-info/
+*.egg-info
 .env
 *.log
 tmp

.github/longmemory.gif

@@ -24,7 +24,19 @@ The package, CLI, environment prefix, extension namespace, routes, and integrati
 - dashboard proxy: `/api/longmemory`
 - repository: `https://github.com/CaviraOSS/LongMemory`
 
-Compatibility aliases for the previous product name are intentionally not shipped.
+Application identifiers do not retain runtime aliases; registry migration is handled by temporary compatibility packages.
+
+Package registry migration uses temporary compatibility bridges:
+
+```bash
+npm uninstall openmemory-js
+npm install longmemory
+
+pip uninstall openmemory-py
+pip install longmemory-sdk
+```
+
+The npm bridge re-exports `longmemory` and forwards the legacy CLI names. The PyPI bridge depends on `longmemory-sdk` and forwards the legacy Python import namespace. The unrelated `longmemory` distribution on PyPI is not part of CaviraOSS.
 
 ## Import legacy memory data
 

.github/longmemory.png

@@ -17,11 +17,12 @@
 > **Durable, temporal, governed memory for AI agents. Not just RAG. Not just a vector database. Local-first and self-hosted.**
 
 [![npm](https://img.shields.io/npm/v/longmemory.svg)](https://www.npmjs.com/package/longmemory)
+[![PyPI](https://img.shields.io/pypi/v/longmemory-sdk.svg)](https://pypi.org/project/longmemory-sdk/)
 [![VS Code](https://img.shields.io/badge/VS%20Code-LongMemory-007ACC?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=CaviraOSS.longmemory-vscode)
 [![Container](https://img.shields.io/badge/GHCR-longmemory-2496ED?logo=docker)](https://github.com/CaviraOSS/LongMemory/pkgs/container/longmemory)
 [![License](https://img.shields.io/github/license/CaviraOSS/LongMemory)](LICENSE)
 
-![LongMemory dashboard](.github/longmemory.png)
+![LongMemory dashboard](.github/longmemory.gif)
 
 LongMemory is a cognitive memory engine for LLM applications and autonomous agents.
 
@@ -86,6 +87,27 @@ longmemory init
 longmemory recall "current project priorities" --mode associative
 ```
 
+### Call a self-hosted server from Python
+
+```bash
+pip install longmemory-sdk
+```
+
+```python
+from longmemory import LongMemory
+
+memory = LongMemory(
+    "http://127.0.0.1:7331",
+    api_key="change-me",
+    user_id="alice",
+)
+
+memory.ingest("I prefer TypeScript")
+result = memory.recall("What language do I prefer?", mode="strict")
+```
+
+The Python package is a zero-dependency HTTP client. The Hydrograph engine remains in the self-hosted TypeScript service. See [docs/python-sdk.md](docs/python-sdk.md).
+
 ---
 
 ## 2. Run as a Service
@@ -375,6 +397,15 @@ longmemory port --from codex --to longmemory --all
 
 See [MIGRATION.md](MIGRATION.md) and [docs/migration.md](docs/migration.md).
 
+Legacy package migration:
+
+```bash
+npm uninstall openmemory-js && npm install longmemory
+pip uninstall openmemory-py && pip install longmemory-sdk
+```
+
+`openmemory-js@2` and `openmemory-py@2` are forwarding bridges for existing installations. New applications should use `longmemory` and `longmemory-sdk` directly. PyPI's unrelated `longmemory` name is owned by another project, so the official distribution is `longmemory-sdk` while the import remains `longmemory`.
+
 ---
 
 ## 14. Release and Operations

.github/workflows/publish-sdks.yml

@@ -0,0 +1,13 @@
+/*
+*      __                      __  ___
+*     / /   ____  ____  ____ _/  |/  /__  ____ ___  ____  _______  __
+*    / /   / __ \/ __ \/ __ `/ /|_/ / _ \/ __ `__ \/ __ \/ ___/ / / /
+*   / /___/ /_/ / / / / /_/ / /  / /  __/ / / / / / /_/ / /  / /_/ /
+*  /_____/\____/_/ /_/\__, /_/  /_/\___/_/ /_/ /_/\____/_/   \__, /
+                     /____/                                 /____/
+ *
+ *  cavira oss (c) 2026  -  nullure (c) 2026
+ *  ----------------------------------------------------------
+ *  file  : {{file}}
+ *  usage : {{usage}}
+ */