becomer 0.1.0__tar.gz

becomer-0.1.0/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: becomer
+Version: 0.1.0
+Summary: Persistent memory API for any LLM — Python SDK + MCP server
+Home-page: https://becomer.net
+Author: BECOMER
+Author-email: hello@becomer.net
+Project-URL: Documentation, https://becomer.net
+Keywords: memory,llm,ai,mcp,claude,gpt,persistent-memory
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/plain
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+BECOMER gives any LLM persistent memory. Store, recall, and forget memories via a simple API. Includes a built-in MCP server for Claude Desktop and compatible clients. See https://becomer.net for full documentation.

becomer-0.1.0/becomer/__init__.py

@@ -0,0 +1,4 @@
+from .client import Client
+
+__all__ = ["Client"]
+__version__ = "0.1.0"

becomer-0.1.0/becomer/__main__.py

@@ -0,0 +1,122 @@
+"""
+BECOMER MCP server — exposes store/recall/forget as MCP tools.
+
+Usage in mcp.json:
+  {
+    "mcpServers": {
+      "becomer": {
+        "command": "python",
+        "args": ["-m", "becomer"],
+        "env": { "BECOMER_API_KEY": "YOUR_API_KEY" }
+      }
+    }
+  }
+"""
+import os
+import sys
+import json
+
+from .client import Client, BecomerError
+
+TOOLS = [
+    {
+        "name": "store",
+        "description": "Store a memory in BECOMER. Call this when you learn something worth remembering about the user.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "content": {"type": "string", "description": "The memory to store."}
+            },
+            "required": ["content"],
+        },
+    },
+    {
+        "name": "recall",
+        "description": "Recall relevant memories from BECOMER for a query.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "query": {"type": "string", "description": "What to search for in memory."},
+                "top_k": {"type": "integer", "description": "Number of memories to return (default 5).", "default": 5},
+            },
+            "required": ["query"],
+        },
+    },
+    {
+        "name": "forget",
+        "description": "Delete all memories stored under this API key.",
+        "inputSchema": {"type": "object", "properties": {}},
+    },
+]
+
+
+def send(obj: dict) -> None:
+    sys.stdout.write(json.dumps(obj) + "\n")
+    sys.stdout.flush()
+
+
+def handle(msg: dict, client: Client) -> dict:
+    method = msg.get("method", "")
+    mid = msg.get("id")
+
+    if method == "initialize":
+        return {
+            "jsonrpc": "2.0", "id": mid,
+            "result": {
+                "protocolVersion": "2024-11-05",
+                "capabilities": {"tools": {}},
+                "serverInfo": {"name": "becomer", "version": "0.1.0"},
+            },
+        }
+
+    if method == "tools/list":
+        return {"jsonrpc": "2.0", "id": mid, "result": {"tools": TOOLS}}
+
+    if method == "tools/call":
+        name = msg["params"]["name"]
+        args = msg["params"].get("arguments", {})
+        try:
+            if name == "store":
+                result = client.store(args["content"])
+                text = "Memory stored."
+            elif name == "recall":
+                memories = client.recall(args["query"], args.get("top_k", 5))
+                text = "\n".join(f"- {m}" for m in memories) if memories else "No relevant memories found."
+            elif name == "forget":
+                client.forget()
+                text = "All memories deleted."
+            else:
+                text = f"Unknown tool: {name}"
+        except BecomerError as e:
+            text = f"Error: {e}"
+
+        return {
+            "jsonrpc": "2.0", "id": mid,
+            "result": {"content": [{"type": "text", "text": text}]},
+        }
+
+    return {"jsonrpc": "2.0", "id": mid, "result": {}}
+
+
+def main() -> None:
+    api_key = os.environ.get("BECOMER_API_KEY", "")
+    if not api_key:
+        sys.stderr.write("BECOMER_API_KEY environment variable not set\n")
+        sys.exit(1)
+
+    client = Client(api_key)
+
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            msg = json.loads(line)
+            response = handle(msg, client)
+            send(response)
+        except Exception as e:
+            sys.stderr.write(f"Error: {e}\n")
+
+
+if __name__ == "__main__":
+    main()

becomer-0.1.0/becomer/client.py

@@ -0,0 +1,55 @@
+import urllib.request
+import urllib.error
+import json
+from typing import Optional
+
+BASE_URL = "https://becomer.net"
+
+
+class BecomerError(Exception):
+    pass
+
+
+class Client:
+    def __init__(self, api_key: str, base_url: str = BASE_URL):
+        if not api_key:
+            raise BecomerError("api_key is required")
+        self._key = api_key
+        self._base = base_url.rstrip("/")
+
+    def _request(self, method: str, path: str, body: Optional[dict] = None) -> dict:
+        url = self._base + path
+        data = json.dumps(body).encode() if body else None
+        req = urllib.request.Request(
+            url,
+            data=data,
+            headers={
+                "Authorization": f"Bearer {self._key}",
+                "Content-Type": "application/json",
+            },
+            method=method,
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=15) as r:
+                return json.loads(r.read().decode())
+        except urllib.error.HTTPError as e:
+            raise BecomerError(f"HTTP {e.code}: {e.read().decode()}") from e
+        except Exception as e:
+            raise BecomerError(str(e)) from e
+
+    def store(self, content: str) -> dict:
+        """Store a memory."""
+        return self._request("POST", "/v1/store", {"content": content})
+
+    def recall(self, query: str, top_k: int = 5) -> list[str]:
+        """Recall relevant memories for a query."""
+        result = self._request("POST", "/v1/recall", {"query": query, "top_k": top_k})
+        return result.get("memories", [])
+
+    def forget(self) -> dict:
+        """Delete all memories for this API key."""
+        return self._request("POST", "/v1/forget", {"forget_all": True})
+
+    def sync(self) -> dict:
+        """Consolidate working memory into long-term storage."""
+        return self._request("POST", "/v1/sync", {})

becomer-0.1.0/becomer.egg-info/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: becomer
+Version: 0.1.0
+Summary: Persistent memory API for any LLM — Python SDK + MCP server
+Home-page: https://becomer.net
+Author: BECOMER
+Author-email: hello@becomer.net
+Project-URL: Documentation, https://becomer.net
+Keywords: memory,llm,ai,mcp,claude,gpt,persistent-memory
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/plain
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+BECOMER gives any LLM persistent memory. Store, recall, and forget memories via a simple API. Includes a built-in MCP server for Claude Desktop and compatible clients. See https://becomer.net for full documentation.

becomer-0.1.0/becomer.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+pyproject.toml
+setup.py
+becomer/__init__.py
+becomer/__main__.py
+becomer/client.py
+becomer.egg-info/PKG-INFO
+becomer.egg-info/SOURCES.txt
+becomer.egg-info/dependency_links.txt
+becomer.egg-info/entry_points.txt
+becomer.egg-info/top_level.txt

becomer-0.1.0/becomer.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

becomer-0.1.0/becomer.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+becomer = becomer.__main__:main

becomer-0.1.0/becomer.egg-info/top_level.txt

@@ -0,0 +1 @@
+becomer

becomer-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

becomer-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

becomer-0.1.0/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="becomer",
+    version="0.1.0",
+    description="Persistent memory API for any LLM — Python SDK + MCP server",
+    long_description=(
+        "BECOMER gives any LLM persistent memory. "
+        "Store, recall, and forget memories via a simple API. "
+        "Includes a built-in MCP server for Claude Desktop and compatible clients. "
+        "See https://becomer.net for full documentation."
+    ),
+    long_description_content_type="text/plain",
+    author="BECOMER",
+    author_email="hello@becomer.net",
+    url="https://becomer.net",
+    project_urls={
+        "Documentation": "https://becomer.net",
+    },
+    packages=find_packages(exclude=["__pycache__"]),
+    python_requires=">=3.9",
+    install_requires=[],
+    entry_points={
+        "console_scripts": ["becomer=becomer.__main__:main"],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    keywords=["memory", "llm", "ai", "mcp", "claude", "gpt", "persistent-memory"],
+)