mnemosyne-sdk 0.1.0__tar.gz

mnemosyne_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geass Labs
+
+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.

mnemosyne_sdk-0.1.0/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geass Labs
+
+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.

mnemosyne_sdk-0.1.0/NOTICE

@@ -0,0 +1,79 @@
+Mnemosyne & Syne — Dual-License Notice
+======================================
+
+This repository, github.com/synet-systems/mnemosyne, contains two classes of
+artifacts distributed under DIFFERENT licenses.
+
+1. THE MONOREPO SOURCE
+   The full source code in this repository — including the Mnemosyne engine
+   (mnemosyne/), the Syne voice+avatar companion (syne/), the Rust kernels
+   (mnemosyne_rs/, syne_rs/), the React UI (mnemosyne_ui/), the legacy
+   Sovereign Memory code (sovereign_memory*/), documentation, and benchmark
+   code — is licensed under the Mnemosyne Source-Available License v1.0
+   (MSAL v1.0). See ./LICENSE for the full text.
+
+   The MSAL is NOT an OSI-approved open-source license. It permits viewing,
+   reading, security review, interoperability study, and non-commercial
+   academic research, but it RESTRICTS commercial use, modification,
+   redistribution, and offering as a hosted service. Commercial use requires
+   a separate written agreement with Geass Labs — see
+   https://geasslabs.com/licensing or licensing@geasslabs.com.
+
+2. PUBLISHED PACKAGES
+   The following packages, which are extracted from this monorepo and
+   distributed through public registries (PyPI, npm, crates.io, GitHub
+   Releases), are licensed under the MIT License. See ./LICENSE-MIT for the
+   full text.
+
+   Python (PyPI):
+     - mnemosyne-sdk
+     - mnemosyne-mcp-server
+     - mnemosyne-langchain
+     - mnemosyne-crewai
+     - mnemosyne-autogen
+     - mnemosyne-openai-agents
+     - mnemosyne-connectors
+     - syne
+
+   JavaScript / TypeScript (npm):
+     - @mnemosyne/sdk
+     - @mnemosyne/mcp-server
+     - @mnemosyne/langchain
+     - @mnemosyne/vercel-ai
+     - @mnemosyne/react
+     - @mnemosyne/cli
+     - @mnemosyne/types
+
+   Rust (crates.io):
+     - mnemosyne-rs
+     - syne (workspace)
+
+   Binaries (GitHub Releases):
+     - syne-supervisor
+
+   The MIT-licensed published packages are designed to talk to a Mnemosyne
+   or Syne instance, which itself is governed by the MSAL. Combining the
+   MIT-licensed clients with a self-hosted MSAL-licensed server is
+   permitted by both licenses.
+
+WHY THIS PATTERN
+----------------
+This is the standard source-available distribution model used by companies
+such as Sourcegraph, Sentry, and HashiCorp: the source is visible and
+auditable under a restricted license, while the redistributable client
+artifacts (SDKs, CLI, MCP server, framework adapters) ship under a
+permissive license so that downstream developers can build commercial
+products on top of the open ecosystem without friction.
+
+The full Mnemosyne engine is also available for production deployment
+under the Mnemosyne Teams and Mnemosyne Enterprise tiers. See
+https://mnemosyne.geasslabs.com for details.
+
+TRADEMARKS
+----------
+"Mnemosyne", "Agent Soul", "Syne", and the Geass Labs wordmarks are
+trademarks of Geass Labs. The MIT license does NOT grant permission to
+use these trademarks; see the Geass Labs trademark policy at
+https://geasslabs.com/trademarks.
+
+Copyright (c) 2026 Geass Labs.

mnemosyne_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: mnemosyne-sdk
+Version: 0.1.0
+Summary: Official Python SDK for the Mnemosyne memory substrate. Sync and async clients, container-scoped storage, hybrid BM25+vector recall, full Pydantic type stubs. Talks to any Mnemosyne endpoint over HTTPS via httpx.
+Author-email: Mashle Burneded <mashle@geasslabs.xyz>
+Maintainer-email: Geass Labs <team@geasslabs.xyz>
+License: MIT License
+        
+        Copyright (c) 2026 Geass Labs
+        
+        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.
+        
+Project-URL: Homepage, https://mnemosyne.geasslabs.xyz
+Project-URL: Documentation, https://docs.geasslabs.xyz/mnemosyne-sdk
+Project-URL: Repository, https://github.com/synet-systems/mnemosyne/tree/main/packages/mnemosyne-sdk-python
+Project-URL: Issues, https://github.com/synet-systems/mnemosyne/issues
+Project-URL: Changelog, https://github.com/synet-systems/mnemosyne/blob/main/packages/mnemosyne-sdk-python/CHANGELOG.md
+Keywords: mnemosyne,ai,llm,memory,agent,agent-memory,rag,retrieval-augmented-generation,long-term-memory,vector-search,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE-MIT
+License-File: NOTICE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: respx>=0.21.0; extra == "dev"
+Requires-Dist: anyio>=4.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: mnemosyne-langchain>=0.1.0; extra == "all"
+Requires-Dist: mnemosyne-crewai>=0.1.0; extra == "all"
+Requires-Dist: mnemosyne-autogen>=0.1.0; extra == "all"
+Requires-Dist: mnemosyne-openai-agents>=0.1.0; extra == "all"
+Dynamic: license-file
+
+# mnemosyne-sdk
+
+[![PyPI version](https://img.shields.io/pypi/v/mnemosyne-sdk.svg)](https://pypi.org/project/mnemosyne-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/mnemosyne-sdk.svg)](https://pypi.org/project/mnemosyne-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![CI](https://github.com/synet-systems/mnemosyne/actions/workflows/ci.yml/badge.svg)](https://github.com/synet-systems/mnemosyne/actions)
+
+> The official Python client for the Mnemosyne memory substrate. Synchronous and async APIs, container-scoped storage, hybrid BM25+vector recall, full type stubs. Talks to any Mnemosyne endpoint over HTTPS via httpx.
+
+Mnemosyne gives any AI system persistent identity, episodic recall, contradiction resolution, metacognition, and a self-model that compounds across sessions. This SDK is the thin HTTP client that talks to a Mnemosyne Cloud or self-hosted Mnemosyne instance.
+
+## Install
+
+```bash
+pip install mnemosyne-sdk
+# or
+uv add mnemosyne-sdk
+# or
+poetry add mnemosyne-sdk
+```
+
+## Quick start
+
+```python
+from mnemosyne_sdk import Mnemosyne
+
+mn = Mnemosyne(
+    api_key="mn_...",  # from your Mnemosyne dashboard
+    # base_url="https://api.mnemosyne.geasslabs.xyz",  # default
+)
+
+# Save a memory
+memory = mn.add(
+    "The dock-A camera lost calibration at 14:32 UTC",
+    container_tag="fleet-ops",
+    metadata={"severity": "high"},
+)
+print(memory.id)
+
+# Search
+results = mn.search("when did dock A fail?", container_tag="fleet-ops")
+for r in results:
+    print(f"{r.score:.3f}  {r.content}")
+
+# Get / delete
+one = mn.get(memory.id)
+mn.delete(memory.id)
+```
+
+## Async client
+
+```python
+import asyncio
+from mnemosyne_sdk import AsyncMnemosyne
+
+async def main():
+    async with AsyncMnemosyne(api_key="mn_...") as mn:
+        await mn.add("...", container_tag="fleet-ops")
+        results = await mn.search("query", container_tag="fleet-ops")
+
+asyncio.run(main())
+```
+
+The async client shares the same `httpx` connection pool and is recommended for high-throughput agents.
+
+## Function-calling tools
+
+```python
+from mnemosyne_sdk import TOOLS, execute_tool
+
+# Pass TOOLS to any OpenAI-compatible function-calling API
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[...],
+    tools=TOOLS,
+)
+
+# Execute a tool call from the model's response
+for call in response.choices[0].message.tool_calls:
+    result = execute_tool(
+        call.function.name,
+        call.function.arguments,
+        base_url="https://api.mnemosyne.geasslabs.xyz",
+        api_key="mn_...",
+    )
+```
+
+## Framework adapters
+
+This package is the *core* client. For framework-specific integrations, install one of the dedicated adapter packages:
+
+| Framework | Package | Install |
+|---|---|---|
+| LangChain / LangGraph | `mnemosyne-langchain` | `pip install mnemosyne-sdk[langchain]` |
+| CrewAI | `mnemosyne-crewai` | `pip install mnemosyne-sdk[crewai]` |
+| AutoGen v0.4 | `mnemosyne-autogen` | `pip install mnemosyne-sdk[autogen]` |
+| OpenAI Agents SDK | `mnemosyne-openai-agents` | `pip install mnemosyne-sdk[openai-agents]` |
+
+Or install everything: `pip install mnemosyne-sdk[all]`.
+
+## Error handling
+
+```python
+from mnemosyne_sdk import Mnemosyne, AuthenticationError, RateLimitError
+
+mn = Mnemosyne(api_key="...")
+
+try:
+    mn.add("...")
+except AuthenticationError:
+    ...  # bad API key
+except RateLimitError as e:
+    time.sleep(e.retry_after or 1)
+    ...  # back off
+```
+
+All errors inherit from `MnemosyneError`.
+
+## Configuration
+
+| Env var | Description | Default |
+|---|---|---|
+| `MNEMOSYNE_API_KEY` | API key (overridden by constructor) | - |
+| `MNEMOSYNE_BASE_URL` | Server URL | `https://api.mnemosyne.geasslabs.xyz` |
+| `MNEMOSYNE_CONTAINER` | Default container tag | `default` |
+
+## Development
+
+```bash
+git clone https://github.com/synet-systems/mnemosyne
+cd mnemosyne/packages/mnemosyne-sdk-python
+uv sync --all-extras
+uv run pytest
+```
+
+## License
+
+MIT © [Geass Labs](https://geasslabs.xyz). The Mnemosyne *engine* this SDK talks to is licensed under the [Mnemosyne Source-Available License v1.0](https://github.com/synet-systems/mnemosyne/blob/main/LICENSE). See [`NOTICE`](https://github.com/synet-systems/mnemosyne/blob/main/NOTICE) for the dual-license arrangement.
+
+## Links
+
+- **Homepage**: https://mnemosyne.geasslabs.xyz
+- **Documentation**: https://docs.geasslabs.xyz/mnemosyne-sdk
+- **Repository**: https://github.com/synet-systems/mnemosyne
+- **Issues**: https://github.com/synet-systems/mnemosyne/issues
+- **Changelog**: [CHANGELOG.md](./CHANGELOG.md)

mnemosyne_sdk-0.1.0/README.md

@@ -0,0 +1,146 @@
+# mnemosyne-sdk
+
+[![PyPI version](https://img.shields.io/pypi/v/mnemosyne-sdk.svg)](https://pypi.org/project/mnemosyne-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/mnemosyne-sdk.svg)](https://pypi.org/project/mnemosyne-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![CI](https://github.com/synet-systems/mnemosyne/actions/workflows/ci.yml/badge.svg)](https://github.com/synet-systems/mnemosyne/actions)
+
+> The official Python client for the Mnemosyne memory substrate. Synchronous and async APIs, container-scoped storage, hybrid BM25+vector recall, full type stubs. Talks to any Mnemosyne endpoint over HTTPS via httpx.
+
+Mnemosyne gives any AI system persistent identity, episodic recall, contradiction resolution, metacognition, and a self-model that compounds across sessions. This SDK is the thin HTTP client that talks to a Mnemosyne Cloud or self-hosted Mnemosyne instance.
+
+## Install
+
+```bash
+pip install mnemosyne-sdk
+# or
+uv add mnemosyne-sdk
+# or
+poetry add mnemosyne-sdk
+```
+
+## Quick start
+
+```python
+from mnemosyne_sdk import Mnemosyne
+
+mn = Mnemosyne(
+    api_key="mn_...",  # from your Mnemosyne dashboard
+    # base_url="https://api.mnemosyne.geasslabs.xyz",  # default
+)
+
+# Save a memory
+memory = mn.add(
+    "The dock-A camera lost calibration at 14:32 UTC",
+    container_tag="fleet-ops",
+    metadata={"severity": "high"},
+)
+print(memory.id)
+
+# Search
+results = mn.search("when did dock A fail?", container_tag="fleet-ops")
+for r in results:
+    print(f"{r.score:.3f}  {r.content}")
+
+# Get / delete
+one = mn.get(memory.id)
+mn.delete(memory.id)
+```
+
+## Async client
+
+```python
+import asyncio
+from mnemosyne_sdk import AsyncMnemosyne
+
+async def main():
+    async with AsyncMnemosyne(api_key="mn_...") as mn:
+        await mn.add("...", container_tag="fleet-ops")
+        results = await mn.search("query", container_tag="fleet-ops")
+
+asyncio.run(main())
+```
+
+The async client shares the same `httpx` connection pool and is recommended for high-throughput agents.
+
+## Function-calling tools
+
+```python
+from mnemosyne_sdk import TOOLS, execute_tool
+
+# Pass TOOLS to any OpenAI-compatible function-calling API
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[...],
+    tools=TOOLS,
+)
+
+# Execute a tool call from the model's response
+for call in response.choices[0].message.tool_calls:
+    result = execute_tool(
+        call.function.name,
+        call.function.arguments,
+        base_url="https://api.mnemosyne.geasslabs.xyz",
+        api_key="mn_...",
+    )
+```
+
+## Framework adapters
+
+This package is the *core* client. For framework-specific integrations, install one of the dedicated adapter packages:
+
+| Framework | Package | Install |
+|---|---|---|
+| LangChain / LangGraph | `mnemosyne-langchain` | `pip install mnemosyne-sdk[langchain]` |
+| CrewAI | `mnemosyne-crewai` | `pip install mnemosyne-sdk[crewai]` |
+| AutoGen v0.4 | `mnemosyne-autogen` | `pip install mnemosyne-sdk[autogen]` |
+| OpenAI Agents SDK | `mnemosyne-openai-agents` | `pip install mnemosyne-sdk[openai-agents]` |
+
+Or install everything: `pip install mnemosyne-sdk[all]`.
+
+## Error handling
+
+```python
+from mnemosyne_sdk import Mnemosyne, AuthenticationError, RateLimitError
+
+mn = Mnemosyne(api_key="...")
+
+try:
+    mn.add("...")
+except AuthenticationError:
+    ...  # bad API key
+except RateLimitError as e:
+    time.sleep(e.retry_after or 1)
+    ...  # back off
+```
+
+All errors inherit from `MnemosyneError`.
+
+## Configuration
+
+| Env var | Description | Default |
+|---|---|---|
+| `MNEMOSYNE_API_KEY` | API key (overridden by constructor) | - |
+| `MNEMOSYNE_BASE_URL` | Server URL | `https://api.mnemosyne.geasslabs.xyz` |
+| `MNEMOSYNE_CONTAINER` | Default container tag | `default` |
+
+## Development
+
+```bash
+git clone https://github.com/synet-systems/mnemosyne
+cd mnemosyne/packages/mnemosyne-sdk-python
+uv sync --all-extras
+uv run pytest
+```
+
+## License
+
+MIT © [Geass Labs](https://geasslabs.xyz). The Mnemosyne *engine* this SDK talks to is licensed under the [Mnemosyne Source-Available License v1.0](https://github.com/synet-systems/mnemosyne/blob/main/LICENSE). See [`NOTICE`](https://github.com/synet-systems/mnemosyne/blob/main/NOTICE) for the dual-license arrangement.
+
+## Links
+
+- **Homepage**: https://mnemosyne.geasslabs.xyz
+- **Documentation**: https://docs.geasslabs.xyz/mnemosyne-sdk
+- **Repository**: https://github.com/synet-systems/mnemosyne
+- **Issues**: https://github.com/synet-systems/mnemosyne/issues
+- **Changelog**: [CHANGELOG.md](./CHANGELOG.md)

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

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: mnemosyne-sdk
+Version: 0.1.0
+Summary: Official Python SDK for the Mnemosyne memory substrate. Sync and async clients, container-scoped storage, hybrid BM25+vector recall, full Pydantic type stubs. Talks to any Mnemosyne endpoint over HTTPS via httpx.
+Author-email: Mashle Burneded <mashle@geasslabs.xyz>
+Maintainer-email: Geass Labs <team@geasslabs.xyz>
+License: MIT License
+        
+        Copyright (c) 2026 Geass Labs
+        
+        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.
+        
+Project-URL: Homepage, https://mnemosyne.geasslabs.xyz
+Project-URL: Documentation, https://docs.geasslabs.xyz/mnemosyne-sdk
+Project-URL: Repository, https://github.com/synet-systems/mnemosyne/tree/main/packages/mnemosyne-sdk-python
+Project-URL: Issues, https://github.com/synet-systems/mnemosyne/issues
+Project-URL: Changelog, https://github.com/synet-systems/mnemosyne/blob/main/packages/mnemosyne-sdk-python/CHANGELOG.md
+Keywords: mnemosyne,ai,llm,memory,agent,agent-memory,rag,retrieval-augmented-generation,long-term-memory,vector-search,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE-MIT
+License-File: NOTICE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: respx>=0.21.0; extra == "dev"
+Requires-Dist: anyio>=4.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: mnemosyne-langchain>=0.1.0; extra == "all"
+Requires-Dist: mnemosyne-crewai>=0.1.0; extra == "all"
+Requires-Dist: mnemosyne-autogen>=0.1.0; extra == "all"
+Requires-Dist: mnemosyne-openai-agents>=0.1.0; extra == "all"
+Dynamic: license-file
+
+# mnemosyne-sdk
+
+[![PyPI version](https://img.shields.io/pypi/v/mnemosyne-sdk.svg)](https://pypi.org/project/mnemosyne-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/mnemosyne-sdk.svg)](https://pypi.org/project/mnemosyne-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![CI](https://github.com/synet-systems/mnemosyne/actions/workflows/ci.yml/badge.svg)](https://github.com/synet-systems/mnemosyne/actions)
+
+> The official Python client for the Mnemosyne memory substrate. Synchronous and async APIs, container-scoped storage, hybrid BM25+vector recall, full type stubs. Talks to any Mnemosyne endpoint over HTTPS via httpx.
+
+Mnemosyne gives any AI system persistent identity, episodic recall, contradiction resolution, metacognition, and a self-model that compounds across sessions. This SDK is the thin HTTP client that talks to a Mnemosyne Cloud or self-hosted Mnemosyne instance.
+
+## Install
+
+```bash
+pip install mnemosyne-sdk
+# or
+uv add mnemosyne-sdk
+# or
+poetry add mnemosyne-sdk
+```
+
+## Quick start
+
+```python
+from mnemosyne_sdk import Mnemosyne
+
+mn = Mnemosyne(
+    api_key="mn_...",  # from your Mnemosyne dashboard
+    # base_url="https://api.mnemosyne.geasslabs.xyz",  # default
+)
+
+# Save a memory
+memory = mn.add(
+    "The dock-A camera lost calibration at 14:32 UTC",
+    container_tag="fleet-ops",
+    metadata={"severity": "high"},
+)
+print(memory.id)
+
+# Search
+results = mn.search("when did dock A fail?", container_tag="fleet-ops")
+for r in results:
+    print(f"{r.score:.3f}  {r.content}")
+
+# Get / delete
+one = mn.get(memory.id)
+mn.delete(memory.id)
+```
+
+## Async client
+
+```python
+import asyncio
+from mnemosyne_sdk import AsyncMnemosyne
+
+async def main():
+    async with AsyncMnemosyne(api_key="mn_...") as mn:
+        await mn.add("...", container_tag="fleet-ops")
+        results = await mn.search("query", container_tag="fleet-ops")
+
+asyncio.run(main())
+```
+
+The async client shares the same `httpx` connection pool and is recommended for high-throughput agents.
+
+## Function-calling tools
+
+```python
+from mnemosyne_sdk import TOOLS, execute_tool
+
+# Pass TOOLS to any OpenAI-compatible function-calling API
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[...],
+    tools=TOOLS,
+)
+
+# Execute a tool call from the model's response
+for call in response.choices[0].message.tool_calls:
+    result = execute_tool(
+        call.function.name,
+        call.function.arguments,
+        base_url="https://api.mnemosyne.geasslabs.xyz",
+        api_key="mn_...",
+    )
+```
+
+## Framework adapters
+
+This package is the *core* client. For framework-specific integrations, install one of the dedicated adapter packages:
+
+| Framework | Package | Install |
+|---|---|---|
+| LangChain / LangGraph | `mnemosyne-langchain` | `pip install mnemosyne-sdk[langchain]` |
+| CrewAI | `mnemosyne-crewai` | `pip install mnemosyne-sdk[crewai]` |
+| AutoGen v0.4 | `mnemosyne-autogen` | `pip install mnemosyne-sdk[autogen]` |
+| OpenAI Agents SDK | `mnemosyne-openai-agents` | `pip install mnemosyne-sdk[openai-agents]` |
+
+Or install everything: `pip install mnemosyne-sdk[all]`.
+
+## Error handling
+
+```python
+from mnemosyne_sdk import Mnemosyne, AuthenticationError, RateLimitError
+
+mn = Mnemosyne(api_key="...")
+
+try:
+    mn.add("...")
+except AuthenticationError:
+    ...  # bad API key
+except RateLimitError as e:
+    time.sleep(e.retry_after or 1)
+    ...  # back off
+```
+
+All errors inherit from `MnemosyneError`.
+
+## Configuration
+
+| Env var | Description | Default |
+|---|---|---|
+| `MNEMOSYNE_API_KEY` | API key (overridden by constructor) | - |
+| `MNEMOSYNE_BASE_URL` | Server URL | `https://api.mnemosyne.geasslabs.xyz` |
+| `MNEMOSYNE_CONTAINER` | Default container tag | `default` |
+
+## Development
+
+```bash
+git clone https://github.com/synet-systems/mnemosyne
+cd mnemosyne/packages/mnemosyne-sdk-python
+uv sync --all-extras
+uv run pytest
+```
+
+## License
+
+MIT © [Geass Labs](https://geasslabs.xyz). The Mnemosyne *engine* this SDK talks to is licensed under the [Mnemosyne Source-Available License v1.0](https://github.com/synet-systems/mnemosyne/blob/main/LICENSE). See [`NOTICE`](https://github.com/synet-systems/mnemosyne/blob/main/NOTICE) for the dual-license arrangement.
+
+## Links
+
+- **Homepage**: https://mnemosyne.geasslabs.xyz
+- **Documentation**: https://docs.geasslabs.xyz/mnemosyne-sdk
+- **Repository**: https://github.com/synet-systems/mnemosyne
+- **Issues**: https://github.com/synet-systems/mnemosyne/issues
+- **Changelog**: [CHANGELOG.md](./CHANGELOG.md)

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

@@ -0,0 +1,11 @@
+LICENSE
+LICENSE-MIT
+NOTICE
+README.md
+pyproject.toml
+mnemosyne_sdk.egg-info/PKG-INFO
+mnemosyne_sdk.egg-info/SOURCES.txt
+mnemosyne_sdk.egg-info/dependency_links.txt
+mnemosyne_sdk.egg-info/requires.txt
+mnemosyne_sdk.egg-info/top_level.txt
+tests/test_client.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,17 @@
+httpx>=0.27.0
+pydantic>=2.7.0
+
+[all]
+mnemosyne-langchain>=0.1.0
+mnemosyne-crewai>=0.1.0
+mnemosyne-autogen>=0.1.0
+mnemosyne-openai-agents>=0.1.0
+
+[dev]
+pytest>=8.0.0
+pytest-asyncio>=0.23.0
+pytest-cov>=5.0.0
+ruff>=0.5.0
+mypy>=1.10.0
+respx>=0.21.0
+anyio>=4.0.0

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

@@ -0,0 +1 @@
+

mnemosyne_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,97 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mnemosyne-sdk"
+version = "0.1.0"
+description = "Official Python SDK for the Mnemosyne memory substrate. Sync and async clients, container-scoped storage, hybrid BM25+vector recall, full Pydantic type stubs. Talks to any Mnemosyne endpoint over HTTPS via httpx."
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Mashle Burneded", email = "mashle@geasslabs.xyz" },
+]
+maintainers = [
+    { name = "Geass Labs", email = "team@geasslabs.xyz" },
+]
+requires-python = ">=3.11"
+keywords = [
+    "mnemosyne",
+    "ai",
+    "llm",
+    "memory",
+    "agent",
+    "agent-memory",
+    "rag",
+    "retrieval-augmented-generation",
+    "long-term-memory",
+    "vector-search",
+    "sdk",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "httpx>=0.27.0",
+    "pydantic>=2.7.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.5.0",
+    "mypy>=1.10.0",
+    "respx>=0.21.0",
+    "anyio>=4.0.0",
+]
+all = [
+    "mnemosyne-langchain>=0.1.0",
+    "mnemosyne-crewai>=0.1.0",
+    "mnemosyne-autogen>=0.1.0",
+    "mnemosyne-openai-agents>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://mnemosyne.geasslabs.xyz"
+Documentation = "https://docs.geasslabs.xyz/mnemosyne-sdk"
+Repository = "https://github.com/synet-systems/mnemosyne/tree/main/packages/mnemosyne-sdk-python"
+Issues = "https://github.com/synet-systems/mnemosyne/issues"
+Changelog = "https://github.com/synet-systems/mnemosyne/blob/main/packages/mnemosyne-sdk-python/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+include = ["mnemosyne_sdk*"]
+
+[tool.setuptools.package-data]
+mnemosyne_sdk = ["py.typed"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "B", "UP", "N", "C4", "RET", "SIM", "RUF"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"

mnemosyne_sdk-0.1.0/setup.cfg

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

mnemosyne_sdk-0.1.0/tests/test_client.py

@@ -0,0 +1,126 @@
+"""Tests for the sync Mnemosyne client."""
+
+from __future__ import annotations
+
+import pytest
+import respx
+from httpx import Response
+
+from mnemosyne_sdk import (
+    AuthenticationError,
+    Mnemosyne,
+    MnemosyneError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    ValidationError,
+)
+
+
+BASE_URL = "https://api.mnemosyne.test"
+API_KEY = "mn_test_123"
+
+
+@pytest.fixture
+def mn() -> Mnemosyne:
+    return Mnemosyne(api_key=API_KEY, base_url=BASE_URL)
+
+
+class TestAdd:
+    @respx.mock
+    def test_add_returns_memory(self, mn: Mnemosyne) -> None:
+        respx.post(f"{BASE_URL}/memories").mock(
+            return_value=Response(
+                200,
+                json={
+                    "id": "mem_1",
+                    "content": "hello",
+                    "container_tag": "default",
+                    "source": None,
+                    "created_at": "2026-06-14T00:00:00Z",
+                    "updated_at": None,
+                    "metadata": {},
+                },
+            )
+        )
+        mem = mn.add("hello")
+        assert mem.id == "mem_1"
+        assert mem.content == "hello"
+
+    @respx.mock
+    def test_add_passes_container_tag(self, mn: Mnemosyne) -> None:
+        route = respx.post(f"{BASE_URL}/memories").mock(
+            return_value=Response(200, json={
+                "id": "mem_1", "content": "x", "container_tag": "c1",
+                "source": None, "created_at": None, "updated_at": None, "metadata": {}
+            })
+        )
+        mn.add("x", container_tag="c1")
+        sent = route.calls.last.request
+        import json
+        body = json.loads(sent.content)
+        assert body["container_tag"] == "c1"
+
+
+class TestSearch:
+    @respx.mock
+    def test_search_returns_results(self, mn: Mnemosyne) -> None:
+        respx.get(f"{BASE_URL}/memories/search").mock(
+            return_value=Response(200, json={
+                "results": [
+                    {"id": "m1", "content": "foo", "container_tag": "c1", "score": 0.9, "source": None, "metadata": None},
+                ]
+            })
+        )
+        results = mn.search("foo")
+        assert len(results) == 1
+        assert results[0].score == pytest.approx(0.9)
+
+
+class TestErrors:
+    @respx.mock
+    def test_401_raises_authentication_error(self, mn: Mnemosyne) -> None:
+        respx.post(f"{BASE_URL}/memories").mock(
+            return_value=Response(401, json={"detail": "bad key"})
+        )
+        with pytest.raises(AuthenticationError):
+            mn.add("x")
+
+    @respx.mock
+    def test_404_raises_not_found(self, mn: Mnemosyne) -> None:
+        respx.get(f"{BASE_URL}/memories/missing").mock(
+            return_value=Response(404, json={"detail": "not found"})
+        )
+        with pytest.raises(NotFoundError):
+            mn.get("missing")
+
+    @respx.mock
+    def test_429_raises_rate_limit(self, mn: Mnemosyne) -> None:
+        respx.post(f"{BASE_URL}/memories").mock(
+            return_value=Response(429, json={"detail": "slow down"}, headers={"retry-after": "1"})
+        )
+        with pytest.raises(RateLimitError) as exc:
+            mn.add("x")
+        assert exc.value.retry_after == 1
+
+    @respx.mock
+    def test_500_raises_server_error(self, mn: Mnemosyne) -> None:
+        respx.post(f"{BASE_URL}/memories").mock(
+            return_value=Response(500, json={"detail": "oops"})
+        )
+        with pytest.raises(ServerError):
+            mn.add("x")
+
+    @respx.mock
+    def test_422_raises_validation_error(self, mn: Mnemosyne) -> None:
+        respx.post(f"{BASE_URL}/memories").mock(
+            return_value=Response(422, json={"detail": "bad input"})
+        )
+        with pytest.raises(ValidationError):
+            mn.add("")
+
+
+class TestMnemosyneErrorInheritance:
+    def test_all_errors_subclass_mnemosyne_error(self) -> None:
+        for cls in (AuthenticationError, NotFoundError, RateLimitError, ServerError, ValidationError):
+            assert issubclass(cls, MnemosyneError)