docs: replace deleted recall-client SDK refs with ai-recallworks / requests

Author: Steve Paltridge

README.md

@@ -1,4 +1,4 @@
-<!-- @wbx-modified copilot-b1c4 | 2026-04-27 23:58 MTN | v0.3.3 | added ™ to H1 brand | prev: copilot-a3f7@2026-04-24 -->
+<!-- @wbx-modified copilot-b1c4 | 2026-04-28 03:35 MTN | v0.3.4 | replaced deleted recall-client with ai-recallworks; Python uses requests until SDK pkg name resolved | prev: copilot-b1c4@2026-04-27 23:58 MTN -->
 <div align="center">
 
 # Recall&trade;
@@ -7,7 +7,7 @@
 
 [![Tests](https://github.com/RecallWorks/Recall/actions/workflows/test.yml/badge.svg)](https://github.com/RecallWorks/Recall/actions/workflows/test.yml)
 [![Docker](https://github.com/RecallWorks/Recall/actions/workflows/docker.yml/badge.svg)](https://github.com/RecallWorks/Recall/actions/workflows/docker.yml)
-[![PyPI](https://img.shields.io/pypi/v/recall-client?label=pypi%3A%20recall-client&logo=pypi&logoColor=white)](https://pypi.org/project/recall-client/)
+[![PyPI](https://img.shields.io/pypi/v/ai-recallworks?label=pypi%3A%20ai-recallworks&logo=pypi&logoColor=white)](https://pypi.org/project/ai-recallworks/)
 [![npm](https://img.shields.io/npm/v/@recallworks/recall-client?label=npm%3A%20%40recallworks%2Frecall-client&logo=npm&logoColor=white)](https://www.npmjs.com/package/@recallworks/recall-client)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white)](pyproject.toml)
@@ -57,13 +57,13 @@ curl -H "X-API-Key: changeme" \
 ```
 
 ```python
-# Python
-pip install recall-client
-
-from recall_client import RecallClient
-with RecallClient("http://localhost:8787", api_key="changeme") as c:
-    c.remember("first memory", tags="hello")
-    print(c.recall("memory").result)
+# Python (use requests/httpx — no SDK pkg needed)
+import requests
+h = {"X-API-Key": "changeme", "Content-Type": "application/json"}
+requests.post("http://localhost:8787/tool/remember", headers=h,
+              json={"content": "first memory", "tags": "hello"})
+print(requests.post("http://localhost:8787/tool/recall", headers=h,
+                    json={"query": "memory"}).json()["result"])
 ```
 
 ```ts

examples/README.md

@@ -16,7 +16,7 @@ docker run -d --name recall -p 8787:8787 -e API_KEY=changeme \
 ## Run a Python example
 
 ```bash
-pip install recall-client
+pip install requests
 python examples/python/agent_memory.py
 ```
 

examples/python/agent_memory.py

@@ -1,48 +1,55 @@
-# @wbx-modified copilot-a3f7·MTN | 2026-04-24 | minimal Recall agent-memory example
+# @wbx-modified copilot-b1c4 | 2026-04-28 03:38 MTN | v0.2 | rewrote using requests after recall-client SDK pkg deleted from PyPI | prev: copilot-a3f7@2026-04-24
 """End-to-end agent memory: remember, recall, checkpoint.
 
 Run a server first:
     docker run -d -p 8787:8787 -e API_KEY=changeme \
         -v recall-data:/data ghcr.io/recallworks/recall:latest
 
 Then:
-    pip install recall-client
+    pip install requests
     python agent_memory.py
 """
 from __future__ import annotations
 
 import os
 
-from recall_client import RecallClient
+import requests
 
 URL = os.environ.get("RECALL_URL", "http://localhost:8787")
 KEY = os.environ.get("RECALL_KEY", "changeme")
+H = {"X-API-Key": KEY, "Content-Type": "application/json"}
+
+
+def call(tool: str, **payload) -> dict:
+    r = requests.post(f"{URL}/tool/{tool}", headers=H, json=payload, timeout=30)
+    r.raise_for_status()
+    return r.json()
 
 
 def main() -> None:
-    with RecallClient(URL, api_key=KEY) as c:
-        # 0. Health
-        print("server:", c.health())
-
-        # 1. Store a few facts the agent should remember across sessions.
-        c.remember("user prefers dark mode", source="prefs", tags="ui,dark-mode")
-        c.remember("project deadline is 2026-05-15", source="project", tags="deadline")
-        c.remember("lead engineer is Jamie (jamie@example.com)", source="people", tags="contact")
-
-        # 2. Pull them back semantically.
-        hits = c.recall("when is the deadline", n=3)
-        print("\nrecall: when is the deadline")
-        print(hits.result)
-
-        # 3. End-of-session checkpoint so the next agent can pick up.
-        cp = c.checkpoint(
-            intent="onboard new agent to the project",
-            established="user prefers dark mode; deadline 2026-05-15; lead is Jamie",
-            pursuing="prepare kickoff doc draft",
-            open_questions="which team channel does Jamie use?",
-            session="e0a1",
-        )
-        print("\ncheckpoint:", cp.result.splitlines()[0])
+    # 0. Health
+    print("server:", requests.get(f"{URL}/health", headers=H, timeout=10).json())
+
+    # 1. Store a few facts the agent should remember across sessions.
+    call("remember", content="user prefers dark mode", source="prefs", tags="ui,dark-mode")
+    call("remember", content="project deadline is 2026-05-15", source="project", tags="deadline")
+    call("remember", content="lead engineer is Jamie (jamie@example.com)", source="people", tags="contact")
+
+    # 2. Pull them back semantically.
+    hits = call("recall", query="when is the deadline", n=3)
+    print("\nrecall: when is the deadline")
+    print(hits["result"])
+
+    # 3. End-of-session checkpoint so the next agent can pick up.
+    cp = call(
+        "checkpoint",
+        intent="onboard new agent to the project",
+        established="user prefers dark mode; deadline 2026-05-15; lead is Jamie",
+        pursuing="prepare kickoff doc draft",
+        open_questions="which team channel does Jamie use?",
+        session="e0a1",
+    )
+    print("\ncheckpoint:", cp["result"].splitlines()[0])
 
 
 if __name__ == "__main__":

pyproject.toml

@@ -1,16 +1,16 @@
-# @wbx-modified copilot-b1c4 | 2026-04-27 23:35 MTN | v0.3.3 | bump for MCP stdio + SSE wiring + Voyage embedder | prev: copilot-a3f7@2026-04-26
+# @wbx-modified copilot-b1c4 | 2026-04-28 03:20 MTN | v0.3.3 | published as ai-recallworks (Steve's choice; passed PyPI similarity wall) | prev: copilot-b1c4@2026-04-28 03:10 MTN
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "recall"
+name = "ai-recallworks"
 version = "0.3.3"
 description = "Open-source agent-memory MCP server. recall.works"
 readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "MIT" }
-authors = [{ name = "Recall contributors" }]
+authors = [{ name = "ai-recallworks" }]
 keywords = ["mcp", "agent", "memory", "rag", "vector-store", "copilot"]
 classifiers = [
     "Development Status :: 3 - Alpha",