memorylayer-py 0.1.0__tar.gz → 0.1.1__tar.gz

memorylayer_py-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yash Patel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

memorylayer_py-0.1.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include src *.py

memorylayer_py-0.1.1/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: memorylayer-py
+Version: 0.1.1
+Summary: Privacy-first memory API for LLMs
+Home-page: https://github.com/patelyash2511/rec0-python
+Author: rec0
+Author-email: rec0 <support@rec0.vercel.app>
+License: MIT
+Project-URL: Homepage, https://rec0.vercel.app
+Project-URL: Documentation, https://rec0.vercel.app/docs
+Project-URL: Repository, https://github.com/patelyash2511/rec0-python
+Project-URL: Bug Tracker, https://github.com/patelyash2511/rec0-python/issues
+Keywords: ai,memory,sdk,rec0,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: mypy>=0.950; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# rec0 Python SDK
+
+Official Python client library for [rec0](https://rec0.vercel.app) - Persistent memory infrastructure for AI applications.
+
+[![PyPI version](https://badge.fury.io/py/memorylayer-py.svg)](https://pypi.org/project/memorylayer-py/)
+[![Tests](https://github.com/patelyash2511/rec0-python/workflows/tests/badge.svg)](https://github.com/patelyash2511/rec0-python/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quick Start
+
+```python
+from rec0 import Memory
+
+# Initialize with your API key
+mem = Memory(
+    api_key='r0_live_sk_...',
+    user_id='user_123'
+)
+
+# Store a memory
+mem.store("User prefers dark mode and Italian food")
+
+# Recall relevant memories
+context = mem.recall(query="user preferences")
+print(context)
+# Returns: "User prefers dark mode and Italian food"
+```
+
+## Install
+
+```bash
+pip install memorylayer-py
+```
+
+**Note:** The package name is `memorylayer-py` but you import it as `rec0`:
+
+```python
+from rec0 import Memory  # Import name is 'rec0', not 'memorylayer'
+```
+
+## Get Your API Key
+
+1. Sign up at [rec0.vercel.app](https://rec0.vercel.app)
+2. Get your API key from the dashboard
+3. Start building!
+
+## Documentation
+
+- [Quick Start Guide](docs/quickstart.md)
+- [API Reference](docs/api_reference.md)
+- [Examples](docs/examples.md)
+- [Full Documentation](https://rec0.vercel.app/docs)
+
+## Features
+
+- **Auto-Capture**: Automatically extracts entities, facts, and preferences
+- **Smart Retrieval**: Hybrid BM25 + cosine similarity search
+- **Memory Decay**: Intelligent aging and conflict resolution
+- **Privacy-first**: Per-user encryption, data isolation, and GDPR-compliant deletion. Your users' data is encrypted and never shared with third parties.
+- **LLM-Agnostic**: Works with any LLM (OpenAI, Anthropic, Google, local models)
+
+## rec0 vs Mem0
+
+| rec0 | Mem0 |
+|------|------|
+| Privacy: Per-user encryption & isolation | Standard cloud storage |
+
+## Enterprise Deployment
+
+The Python SDK is fully open source (MIT license). The backend API is
+closed source but available for enterprise on-premise deployment.
+
+For self-hosted deployments, contact: enterprise@rec0.vercel.app
+
+## Examples
+
+### Basic Usage
+
+```python
+from rec0 import Memory
+
+mem = Memory(api_key='r0_...', user_id='user_123')
+
+# Store
+mem.store("User is a Python developer")
+
+# Recall
+context = mem.recall(query="programming")
+```
+
+### AI Chatbot with Memory
+
+```python
+from rec0 import Memory
+from openai import OpenAI
+
+mem = Memory(api_key='r0_...', user_id='user_456')
+ai = OpenAI()
+
+# Get relevant context
+context = mem.recall(query=user_message)
+
+# Send to LLM with context
+response = ai.chat.completions.create(
+    model="gpt-4",
+    messages=[
+        {"role": "system", "content": f"Context: {context}"},
+        {"role": "user", "content": user_message}
+    ]
+)
+
+# Store the conversation
+mem.store(f"User: {user_message}\nAssistant: {response}")
+```
+
+See [examples/](examples/) for more.
+
+## API Reference
+
+### `Memory(api_key, user_id, app_id=None, base_url=None)`
+
+Initialize the memory client.
+
+**Parameters:**
+- `api_key` (str): Your rec0 API key
+- `user_id` (str): Unique identifier for the user
+- `app_id` (str, optional): Application identifier
+- `base_url` (str, optional): Custom API endpoint
+
+### `store(content, metadata=None)`
+
+Store a memory.
+
+**Parameters:**
+- `content` (str): The content to remember
+- `metadata` (dict, optional): Additional metadata
+
+**Returns:** `dict` with `memory_id`
+
+### `recall(query, limit=10)`
+
+Retrieve relevant memories.
+
+**Parameters:**
+- `query` (str): Search query
+- `limit` (int): Maximum number of results
+
+**Returns:** `list` of memory objects
+
+### `delete(memory_id=None, user_id=None)`
+
+Delete memories.
+
+**Parameters:**
+- `memory_id` (str, optional): Specific memory to delete
+- `user_id` (str, optional): Delete all memories for user
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Links
+
+- [rec0.vercel.app](https://rec0.vercel.app)
+- [GitHub](https://github.com/patelyash2511/rec0-python)
+- [Docs](https://rec0.vercel.app/docs)
+
+## Support
+
+- GitHub Issues: [Report bugs](https://github.com/patelyash2511/rec0-python/issues)
+- Email: support@rec0.vercel.app
+
+---
+
+Made with ❤️ by [rec0](https://rec0.vercel.app)

memorylayer_py-0.1.1/README.md

@@ -0,0 +1,179 @@
+# rec0 Python SDK
+
+Official Python client library for [rec0](https://rec0.vercel.app) - Persistent memory infrastructure for AI applications.
+
+[![PyPI version](https://badge.fury.io/py/memorylayer-py.svg)](https://pypi.org/project/memorylayer-py/)
+[![Tests](https://github.com/patelyash2511/rec0-python/workflows/tests/badge.svg)](https://github.com/patelyash2511/rec0-python/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quick Start
+
+```python
+from rec0 import Memory
+
+# Initialize with your API key
+mem = Memory(
+    api_key='r0_live_sk_...',
+    user_id='user_123'
+)
+
+# Store a memory
+mem.store("User prefers dark mode and Italian food")
+
+# Recall relevant memories
+context = mem.recall(query="user preferences")
+print(context)
+# Returns: "User prefers dark mode and Italian food"
+```
+
+## Install
+
+```bash
+pip install memorylayer-py
+```
+
+**Note:** The package name is `memorylayer-py` but you import it as `rec0`:
+
+```python
+from rec0 import Memory  # Import name is 'rec0', not 'memorylayer'
+```
+
+## Get Your API Key
+
+1. Sign up at [rec0.vercel.app](https://rec0.vercel.app)
+2. Get your API key from the dashboard
+3. Start building!
+
+## Documentation
+
+- [Quick Start Guide](docs/quickstart.md)
+- [API Reference](docs/api_reference.md)
+- [Examples](docs/examples.md)
+- [Full Documentation](https://rec0.vercel.app/docs)
+
+## Features
+
+- **Auto-Capture**: Automatically extracts entities, facts, and preferences
+- **Smart Retrieval**: Hybrid BM25 + cosine similarity search
+- **Memory Decay**: Intelligent aging and conflict resolution
+- **Privacy-first**: Per-user encryption, data isolation, and GDPR-compliant deletion. Your users' data is encrypted and never shared with third parties.
+- **LLM-Agnostic**: Works with any LLM (OpenAI, Anthropic, Google, local models)
+
+## rec0 vs Mem0
+
+| rec0 | Mem0 |
+|------|------|
+| Privacy: Per-user encryption & isolation | Standard cloud storage |
+
+## Enterprise Deployment
+
+The Python SDK is fully open source (MIT license). The backend API is
+closed source but available for enterprise on-premise deployment.
+
+For self-hosted deployments, contact: enterprise@rec0.vercel.app
+
+## Examples
+
+### Basic Usage
+
+```python
+from rec0 import Memory
+
+mem = Memory(api_key='r0_...', user_id='user_123')
+
+# Store
+mem.store("User is a Python developer")
+
+# Recall
+context = mem.recall(query="programming")
+```
+
+### AI Chatbot with Memory
+
+```python
+from rec0 import Memory
+from openai import OpenAI
+
+mem = Memory(api_key='r0_...', user_id='user_456')
+ai = OpenAI()
+
+# Get relevant context
+context = mem.recall(query=user_message)
+
+# Send to LLM with context
+response = ai.chat.completions.create(
+    model="gpt-4",
+    messages=[
+        {"role": "system", "content": f"Context: {context}"},
+        {"role": "user", "content": user_message}
+    ]
+)
+
+# Store the conversation
+mem.store(f"User: {user_message}\nAssistant: {response}")
+```
+
+See [examples/](examples/) for more.
+
+## API Reference
+
+### `Memory(api_key, user_id, app_id=None, base_url=None)`
+
+Initialize the memory client.
+
+**Parameters:**
+- `api_key` (str): Your rec0 API key
+- `user_id` (str): Unique identifier for the user
+- `app_id` (str, optional): Application identifier
+- `base_url` (str, optional): Custom API endpoint
+
+### `store(content, metadata=None)`
+
+Store a memory.
+
+**Parameters:**
+- `content` (str): The content to remember
+- `metadata` (dict, optional): Additional metadata
+
+**Returns:** `dict` with `memory_id`
+
+### `recall(query, limit=10)`
+
+Retrieve relevant memories.
+
+**Parameters:**
+- `query` (str): Search query
+- `limit` (int): Maximum number of results
+
+**Returns:** `list` of memory objects
+
+### `delete(memory_id=None, user_id=None)`
+
+Delete memories.
+
+**Parameters:**
+- `memory_id` (str, optional): Specific memory to delete
+- `user_id` (str, optional): Delete all memories for user
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Links
+
+- [rec0.vercel.app](https://rec0.vercel.app)
+- [GitHub](https://github.com/patelyash2511/rec0-python)
+- [Docs](https://rec0.vercel.app/docs)
+
+## Support
+
+- GitHub Issues: [Report bugs](https://github.com/patelyash2511/rec0-python/issues)
+- Email: support@rec0.vercel.app
+
+---
+
+Made with ❤️ by [rec0](https://rec0.vercel.app)

memorylayer_py-0.1.1/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "memorylayer-py"
+version = "0.1.1"
+description = "Privacy-first memory API for LLMs"
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+  { name = "rec0", email = "support@rec0.vercel.app" }
+]
+license = { text = "MIT" }
+keywords = ["ai", "memory", "sdk", "rec0", "llm"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "requests>=2.28.0",
+  "httpx>=0.24.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0.0",
+  "black>=22.0.0",
+  "mypy>=0.950",
+]
+
+[project.urls]
+Homepage = "https://rec0.vercel.app"
+Documentation = "https://rec0.vercel.app/docs"
+Repository = "https://github.com/patelyash2511/rec0-python"
+"Bug Tracker" = "https://github.com/patelyash2511/rec0-python/issues"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = [
+  "integration: integration tests that require external API credentials",
+]

memorylayer_py-0.1.1/setup.py

@@ -0,0 +1,46 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="memorylayer-py",
+    version="0.1.1",
+    author="rec0",
+    author_email="support@rec0.vercel.app",
+    description="Privacy-first memory API for LLMs",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/patelyash2511/rec0-python",
+    project_urls={
+        "Homepage": "https://rec0.vercel.app",
+        "Documentation": "https://rec0.vercel.app/docs",
+        "Bug Tracker": "https://github.com/patelyash2511/rec0-python/issues",
+        "Repository": "https://github.com/patelyash2511/rec0-python",
+    },
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    python_requires=">=3.9",
+    install_requires=[
+        "requests>=2.28.0",
+        "httpx>=0.24.0",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=7.0.0",
+            "black>=22.0.0",
+            "mypy>=0.950",
+        ]
+    },
+)