oortmem 0.2.0__py3-none-any.whl

oortmem/__init__.py

@@ -0,0 +1,3 @@
+"""Oort: open-source memory for AI agents. This package launches the Oort CLI from Python."""
+
+__version__ = "0.2.0"

oortmem/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

oortmem/cli.py

@@ -0,0 +1,108 @@
+"""Run the Oort CLI from Python.
+
+Oort is written in TypeScript and ships on npm as `oortmem`; it needs Node 22.15 or newer.
+This launcher runs an `oort` command that is already installed. Otherwise it runs the
+matching npm release through npx. Arguments, stdin, stdout and the exit code pass through
+unchanged.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import shutil
+import subprocess
+import sys
+from typing import Callable, Iterable, Optional, Sequence
+
+from . import __version__
+
+MIN_NODE = (22, 15)
+NPM_SPEC = f"oortmem@{__version__}"
+# Set on the child so a launcher that finds itself (or another copy of itself) on PATH
+# skips the PATH lookup instead of starting itself forever.
+GUARD = "OORTMEM_PY_LAUNCHER"
+
+HELP = f"""oort needs Node.js {MIN_NODE[0]}.{MIN_NODE[1]} or newer, and none was found.
+
+Install Node from https://nodejs.org, then run this command again. Or install the CLI
+directly with npm:
+
+    npm install -g oortmem
+
+Docs: https://oortcloud.dev/docs
+"""
+
+
+def node_version(node: str) -> Optional[tuple[int, int]]:
+    """The (major, minor) of `node --version`, or None when it cannot be run or read."""
+    try:
+        out = subprocess.run(
+            [node, "--version"], capture_output=True, text=True, timeout=10, check=False
+        ).stdout
+    except (OSError, subprocess.SubprocessError):
+        return None
+    m = re.match(r"v?(\d+)\.(\d+)", out.strip())
+    return (int(m.group(1)), int(m.group(2))) if m else None
+
+
+def path_candidates(name: str, path: Optional[str]) -> Iterable[str]:
+    """Every executable called `name` on PATH, in PATH order."""
+    seen = set()
+    for d in (path or "").split(os.pathsep):
+        if not d:
+            continue
+        found = shutil.which(name, path=d)
+        if found and found not in seen:
+            seen.add(found)
+            yield found
+
+
+def same_file(a: str, b: Optional[str]) -> bool:
+    if not b:
+        return False
+    try:
+        return os.path.samefile(a, b)
+    except OSError:
+        return False
+
+
+def resolve(
+    env: Optional[dict] = None,
+    self_path: Optional[str] = None,
+    candidates: Callable[[str, Optional[str]], Iterable[str]] = path_candidates,
+    which: Callable[[str], Optional[str]] = shutil.which,
+    version: Callable[[str], Optional[tuple[int, int]]] = node_version,
+) -> Optional[list[str]]:
+    """The command to run: an installed `oort`, else npx with the pinned release, else None."""
+    env = os.environ if env is None else env
+    if not env.get(GUARD):
+        for oort in candidates("oort", env.get("PATH")):
+            if not same_file(oort, self_path):
+                return [oort]
+    node, npx = which("node"), which("npx")
+    if node and npx:
+        v = version(node)
+        if v is not None and v >= MIN_NODE:
+            return [npx, "--yes", NPM_SPEC]
+    return None
+
+
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if args == ["--launcher-version"]:
+        print(f"oortmem (Python launcher) {__version__}, runs {NPM_SPEC}")
+        return 0
+    self_path = shutil.which(sys.argv[0]) or sys.argv[0]
+    cmd = resolve(self_path=self_path)
+    if cmd is None:
+        sys.stderr.write(HELP)
+        return 1
+    try:
+        return subprocess.call(cmd + args, env={**os.environ, GUARD: "1"})
+    except KeyboardInterrupt:
+        return 130
+
+
+if __name__ == "__main__":
+    sys.exit(main())

oortmem-0.2.0.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.5
+Name: oortmem
+Version: 0.2.0
+Summary: Open-source memory for AI agents. Runs the Oort CLI (Node 22.15 or newer) from Python.
+Project-URL: Homepage, https://oortcloud.dev
+Project-URL: Source, https://github.com/oortmem/oort
+Project-URL: Documentation, https://oortcloud.dev/docs
+Author: Oort
+License-Expression: Apache-2.0
+Keywords: agents,ai,claude,llm,mcp,memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# oortmem
+
+Open-source memory for AI agents. Old facts are closed out, not overwritten, and every recall can explain why it was picked.
+
+This package installs the `oort` command for Python users. Oort itself is written in TypeScript and published on npm, so it needs **Node.js 22.15 or newer**. The launcher runs an `oort` you already have, or the matching npm release through `npx`. Arguments and exit codes pass straight through.
+
+```sh
+pipx install oortmem
+oort setup
+oort recall "where does the user live"
+```
+
+Without Node, `oort` tells you how to install it. You can also skip Python entirely with `npm install -g oortmem`.
+
+- Docs: https://oortcloud.dev/docs
+- Source: https://github.com/oortmem/oort
+- License: Apache 2.0

oortmem-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+oortmem/__init__.py,sha256=7k6Q6sXoODpWPj0q75JoZPyuskSgrgc4PtbHnJxT7jw,117
+oortmem/__main__.py,sha256=E6Gls0DNz8GQK2K-kOUIx8cYhgANW_CH54VKrfCfs14,52
+oortmem/cli.py,sha256=4PyEo6nMQzeh-Of6FZKW71jZK41edjmHVCM9SZyYJoM,3426
+oortmem-0.2.0.dist-info/METADATA,sha256=iOOxqaGhzuBscmJav8ZTRnxA3UVtqKmWkhbnXHk1uNw,1439
+oortmem-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+oortmem-0.2.0.dist-info/entry_points.txt,sha256=0HDeacgVkFkVIlJuZzR4v2j668qD4hZ1xMQzN9553v0,69
+oortmem-0.2.0.dist-info/RECORD,,

oortmem-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

oortmem-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+oort = oortmem.cli:main
+oortmem = oortmem.cli:main