engram-client 0.1.0__tar.gz

engram_client-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: engram-client
+Version: 0.1.0
+Summary: Python client for Engram Cloud - AI memory infrastructure
+Author: Ronaldo Lima
+License: MIT
+Project-URL: Homepage, https://github.com/limaronaldo/engram
+Project-URL: Repository, https://github.com/limaronaldo/engram
+Keywords: engram,ai,memory,mcp,agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+
+# engram-client
+
+[![PyPI](https://img.shields.io/pypi/v/engram-client)](https://pypi.org/project/engram-client/)
+[![Python](https://img.shields.io/pypi/pyversions/engram-client)](https://pypi.org/project/engram-client/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Python client for [Engram Cloud](https://github.com/limaronaldo/engram-cloud) - AI memory infrastructure for agents.
+
+## Installation
+
+```bash
+pip install engram-client
+```
+
+## Quick Start
+
+```python
+from engram_client import EngramClient
+
+client = EngramClient(
+    base_url="https://engram-cloud-gateway.fly.dev",
+    api_key="ek_...",
+    tenant="my-tenant",
+)
+
+# Create a memory
+memory = client.create(
+    "User prefers dark mode",
+    tags=["preferences", "ui"],
+    workspace="my-project",
+)
+
+# Search (hybrid: BM25 + vector + fuzzy)
+results = client.search("user preferences")
+
+# List with filters
+memories = client.list(limit=20, workspace="my-project")
+
+# Get by ID
+memory = client.get(42)
+
+# Update
+client.update(42, content="User prefers light mode", tags=["preferences"])
+
+# Delete
+client.delete(42)
+
+# Stats
+stats = client.stats()
+```
+
+## Context Manager
+
+```python
+with EngramClient(base_url="...", api_key="...", tenant="...") as client:
+    client.create("Hello from Python SDK")
+```
+
+## API Reference
+
+### `EngramClient(base_url, api_key, tenant)`
+
+| Method | Description |
+|--------|-------------|
+| `create(content, **kwargs)` | Create a memory |
+| `get(id)` | Get memory by ID |
+| `update(id, **kwargs)` | Update a memory |
+| `delete(id)` | Delete a memory |
+| `list(**kwargs)` | List memories with filters |
+| `search(query, **kwargs)` | Hybrid search |
+| `stats()` | Storage statistics |
+
+### Parameters
+
+**create / update kwargs:** `tags`, `workspace`, `memory_type`, `importance`, `metadata`, `tier`
+
+**list kwargs:** `limit`, `offset`, `workspace`, `memory_type`, `tags`, `sort_by`, `sort_order`
+
+**search kwargs:** `limit`, `workspace`, `tags`, `memory_type`, `include_archived`
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+
+## Related
+
+- [Engram](https://github.com/limaronaldo/engram) - Core memory engine (Rust)
+- [Engram Cloud](https://github.com/limaronaldo/engram-cloud) - Multi-tenant SaaS gateway
+- [@engram/client](https://www.npmjs.com/package/@engram/client) - TypeScript client
+
+## License
+
+MIT

engram_client-0.1.0/README.md

@@ -0,0 +1,94 @@
+# engram-client
+
+[![PyPI](https://img.shields.io/pypi/v/engram-client)](https://pypi.org/project/engram-client/)
+[![Python](https://img.shields.io/pypi/pyversions/engram-client)](https://pypi.org/project/engram-client/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Python client for [Engram Cloud](https://github.com/limaronaldo/engram-cloud) - AI memory infrastructure for agents.
+
+## Installation
+
+```bash
+pip install engram-client
+```
+
+## Quick Start
+
+```python
+from engram_client import EngramClient
+
+client = EngramClient(
+    base_url="https://engram-cloud-gateway.fly.dev",
+    api_key="ek_...",
+    tenant="my-tenant",
+)
+
+# Create a memory
+memory = client.create(
+    "User prefers dark mode",
+    tags=["preferences", "ui"],
+    workspace="my-project",
+)
+
+# Search (hybrid: BM25 + vector + fuzzy)
+results = client.search("user preferences")
+
+# List with filters
+memories = client.list(limit=20, workspace="my-project")
+
+# Get by ID
+memory = client.get(42)
+
+# Update
+client.update(42, content="User prefers light mode", tags=["preferences"])
+
+# Delete
+client.delete(42)
+
+# Stats
+stats = client.stats()
+```
+
+## Context Manager
+
+```python
+with EngramClient(base_url="...", api_key="...", tenant="...") as client:
+    client.create("Hello from Python SDK")
+```
+
+## API Reference
+
+### `EngramClient(base_url, api_key, tenant)`
+
+| Method | Description |
+|--------|-------------|
+| `create(content, **kwargs)` | Create a memory |
+| `get(id)` | Get memory by ID |
+| `update(id, **kwargs)` | Update a memory |
+| `delete(id)` | Delete a memory |
+| `list(**kwargs)` | List memories with filters |
+| `search(query, **kwargs)` | Hybrid search |
+| `stats()` | Storage statistics |
+
+### Parameters
+
+**create / update kwargs:** `tags`, `workspace`, `memory_type`, `importance`, `metadata`, `tier`
+
+**list kwargs:** `limit`, `offset`, `workspace`, `memory_type`, `tags`, `sort_by`, `sort_order`
+
+**search kwargs:** `limit`, `workspace`, `tags`, `memory_type`, `include_archived`
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+
+## Related
+
+- [Engram](https://github.com/limaronaldo/engram) - Core memory engine (Rust)
+- [Engram Cloud](https://github.com/limaronaldo/engram-cloud) - Multi-tenant SaaS gateway
+- [@engram/client](https://www.npmjs.com/package/@engram/client) - TypeScript client
+
+## License
+
+MIT

engram_client-0.1.0/engram_client/__init__.py

@@ -0,0 +1,6 @@
+"""Engram Cloud Python SDK - AI memory infrastructure client."""
+
+from engram_client.client import EngramClient
+
+__version__ = "0.1.0"
+__all__ = ["EngramClient"]

engram_client-0.1.0/engram_client/client.py

@@ -0,0 +1,194 @@
+"""Engram Cloud HTTP client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+
+class EngramClient:
+    """Client for the Engram Cloud REST API.
+
+    Usage:
+        client = EngramClient(
+            base_url="https://your-engram-cloud.fly.dev",
+            api_key="ek_...",
+            tenant="my-tenant",
+        )
+
+        # Create a memory
+        memory = client.create("User prefers dark mode", tags=["prefs"])
+
+        # Search
+        results = client.search("user preferences")
+
+        # List
+        memories = client.list(limit=10)
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        api_key: str,
+        tenant: str,
+        timeout: float = 30.0,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.tenant = tenant
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "X-Tenant-Slug": tenant,
+                "Content-Type": "application/json",
+            },
+            timeout=timeout,
+        )
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "EngramClient":
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()
+
+    # -- MCP-over-HTTP helpers --
+
+    def _mcp_call(self, method: str, params: dict[str, Any] | None = None) -> Any:
+        """Execute an MCP tool call over HTTP."""
+        payload = {
+            "jsonrpc": "2.0",
+            "id": 1,
+            "method": "tools/call",
+            "params": {
+                "name": method,
+                "arguments": params or {},
+            },
+        }
+        resp = self._client.post("/v1/mcp", json=payload)
+        resp.raise_for_status()
+        result = resp.json()
+        if "error" in result:
+            raise EngramError(result["error"].get("message", "Unknown error"))
+        return result.get("result", {})
+
+    # -- Memory CRUD --
+
+    def create(
+        self,
+        content: str,
+        *,
+        memory_type: str = "note",
+        tags: list[str] | None = None,
+        workspace: str | None = None,
+        metadata: dict[str, Any] | None = None,
+        importance: float | None = None,
+    ) -> dict[str, Any]:
+        """Create a new memory."""
+        params: dict[str, Any] = {
+            "content": content,
+            "memory_type": memory_type,
+        }
+        if tags:
+            params["tags"] = tags
+        if workspace:
+            params["workspace"] = workspace
+        if metadata:
+            params["metadata"] = metadata
+        if importance is not None:
+            params["importance"] = importance
+        return self._mcp_call("memory_create", params)
+
+    def get(self, memory_id: int) -> dict[str, Any]:
+        """Get a memory by ID."""
+        return self._mcp_call("memory_get", {"id": memory_id})
+
+    def update(
+        self,
+        memory_id: int,
+        *,
+        content: str | None = None,
+        tags: list[str] | None = None,
+        metadata: dict[str, Any] | None = None,
+        importance: float | None = None,
+    ) -> dict[str, Any]:
+        """Update an existing memory."""
+        params: dict[str, Any] = {"id": memory_id}
+        if content is not None:
+            params["content"] = content
+        if tags is not None:
+            params["tags"] = tags
+        if metadata is not None:
+            params["metadata"] = metadata
+        if importance is not None:
+            params["importance"] = importance
+        return self._mcp_call("memory_update", params)
+
+    def delete(self, memory_id: int) -> dict[str, Any]:
+        """Delete a memory."""
+        return self._mcp_call("memory_delete", {"id": memory_id})
+
+    def list(
+        self,
+        *,
+        limit: int = 50,
+        offset: int = 0,
+        workspace: str | None = None,
+        memory_type: str | None = None,
+        tags: list[str] | None = None,
+    ) -> dict[str, Any]:
+        """List memories with optional filters."""
+        params: dict[str, Any] = {"limit": limit, "offset": offset}
+        if workspace:
+            params["workspace"] = workspace
+        if memory_type:
+            params["memory_type"] = memory_type
+        if tags:
+            params["tags"] = tags
+        return self._mcp_call("memory_list", params)
+
+    # -- Search --
+
+    def search(
+        self,
+        query: str,
+        *,
+        limit: int = 10,
+        workspace: str | None = None,
+    ) -> dict[str, Any]:
+        """Hybrid search (BM25 + vector + fuzzy)."""
+        params: dict[str, Any] = {"query": query, "limit": limit}
+        if workspace:
+            params["workspace"] = workspace
+        return self._mcp_call("memory_search", params)
+
+    # -- Graph --
+
+    def related(self, memory_id: int) -> dict[str, Any]:
+        """Get related memories via knowledge graph."""
+        return self._mcp_call("memory_related", {"id": memory_id})
+
+    def link(
+        self,
+        from_id: int,
+        to_id: int,
+        edge_type: str = "related_to",
+    ) -> dict[str, Any]:
+        """Create a link between two memories."""
+        return self._mcp_call(
+            "memory_link",
+            {"from_id": from_id, "to_id": to_id, "edge_type": edge_type},
+        )
+
+    # -- Stats --
+
+    def stats(self) -> dict[str, Any]:
+        """Get memory statistics."""
+        return self._mcp_call("memory_stats", {})
+
+
+class EngramError(Exception):
+    """Error from the Engram API."""

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

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: engram-client
+Version: 0.1.0
+Summary: Python client for Engram Cloud - AI memory infrastructure
+Author: Ronaldo Lima
+License: MIT
+Project-URL: Homepage, https://github.com/limaronaldo/engram
+Project-URL: Repository, https://github.com/limaronaldo/engram
+Keywords: engram,ai,memory,mcp,agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+
+# engram-client
+
+[![PyPI](https://img.shields.io/pypi/v/engram-client)](https://pypi.org/project/engram-client/)
+[![Python](https://img.shields.io/pypi/pyversions/engram-client)](https://pypi.org/project/engram-client/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Python client for [Engram Cloud](https://github.com/limaronaldo/engram-cloud) - AI memory infrastructure for agents.
+
+## Installation
+
+```bash
+pip install engram-client
+```
+
+## Quick Start
+
+```python
+from engram_client import EngramClient
+
+client = EngramClient(
+    base_url="https://engram-cloud-gateway.fly.dev",
+    api_key="ek_...",
+    tenant="my-tenant",
+)
+
+# Create a memory
+memory = client.create(
+    "User prefers dark mode",
+    tags=["preferences", "ui"],
+    workspace="my-project",
+)
+
+# Search (hybrid: BM25 + vector + fuzzy)
+results = client.search("user preferences")
+
+# List with filters
+memories = client.list(limit=20, workspace="my-project")
+
+# Get by ID
+memory = client.get(42)
+
+# Update
+client.update(42, content="User prefers light mode", tags=["preferences"])
+
+# Delete
+client.delete(42)
+
+# Stats
+stats = client.stats()
+```
+
+## Context Manager
+
+```python
+with EngramClient(base_url="...", api_key="...", tenant="...") as client:
+    client.create("Hello from Python SDK")
+```
+
+## API Reference
+
+### `EngramClient(base_url, api_key, tenant)`
+
+| Method | Description |
+|--------|-------------|
+| `create(content, **kwargs)` | Create a memory |
+| `get(id)` | Get memory by ID |
+| `update(id, **kwargs)` | Update a memory |
+| `delete(id)` | Delete a memory |
+| `list(**kwargs)` | List memories with filters |
+| `search(query, **kwargs)` | Hybrid search |
+| `stats()` | Storage statistics |
+
+### Parameters
+
+**create / update kwargs:** `tags`, `workspace`, `memory_type`, `importance`, `metadata`, `tier`
+
+**list kwargs:** `limit`, `offset`, `workspace`, `memory_type`, `tags`, `sort_by`, `sort_order`
+
+**search kwargs:** `limit`, `workspace`, `tags`, `memory_type`, `include_archived`
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+
+## Related
+
+- [Engram](https://github.com/limaronaldo/engram) - Core memory engine (Rust)
+- [Engram Cloud](https://github.com/limaronaldo/engram-cloud) - Multi-tenant SaaS gateway
+- [@engram/client](https://www.npmjs.com/package/@engram/client) - TypeScript client
+
+## License
+
+MIT

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

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+engram_client/__init__.py
+engram_client/client.py
+engram_client.egg-info/PKG-INFO
+engram_client.egg-info/SOURCES.txt
+engram_client.egg-info/dependency_links.txt
+engram_client.egg-info/requires.txt
+engram_client.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

engram_client-0.1.0/engram_client.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.25.0

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

@@ -0,0 +1 @@
+engram_client

engram_client-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "engram-client"
+version = "0.1.0"
+description = "Python client for Engram Cloud - AI memory infrastructure"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [{name = "Ronaldo Lima"}]
+keywords = ["engram", "ai", "memory", "mcp", "agents"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "httpx>=0.25.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/limaronaldo/engram"
+Repository = "https://github.com/limaronaldo/engram"
+
+[tool.setuptools.packages.find]
+include = ["engram_client*"]

engram_client-0.1.0/setup.cfg

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