memra-local 0.2.0__tar.gz

memra_local-0.2.0/LICENSE

@@ -0,0 +1,57 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Ali Von Sensey
+Licensed Work:        memra-local 0.1.0
+                      Copyright (c) 2026 Ali Von Sensey. All rights reserved.
+Additional Use Grant: None
+Change Date:          2030-04-17
+Change License:       Apache License, Version 2.0
+
+-----------------------------------------------------------------------------
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

memra_local-0.2.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include memra_local *.py
+prune tests
+prune **/__pycache__
+prune **/.pytest_cache
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude .DS_Store

memra_local-0.2.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: memra-local
+Version: 0.2.0
+Summary: Local memory server for AI agents — offline, private, fast
+License: BUSL-1.1
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn[standard]>=0.20.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-ulid>=2.0.0
+Requires-Dist: click>=8.0
+Requires-Dist: sentence-transformers>=5.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: mcp[cli]>=1.27.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: httpx; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# memra-local
+
+Local-first memory server for AI agents. Offline, private, fast.
+
+`memra-local` gives your coding agent persistent memory that lives entirely on your machine — no account, no network, no data leaves the laptop. Works with Claude Code, Cursor, Zed, Droid, Hermes Agent, OpenClaw, and any MCP-compatible client.
+
+When you're ready to sync across devices or share with a team, a single command pushes your local namespace to [Memra Cloud](https://usememra.com). Same tools, same API, your choice.
+
+## Install
+
+```bash
+pip install memra-local
+memra mcp          # start the MCP server
+```
+
+Requires Python 3.10+.
+
+## Wire it into your editor
+
+### Claude Code / Cursor
+
+```json
+{
+  "mcpServers": {
+    "memra": {
+      "command": "memra",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### Zed
+
+```json
+{
+  "context_servers": {
+    "memra": {
+      "command": { "path": "memra", "args": ["mcp"] }
+    }
+  }
+}
+```
+
+### Droid (Factory.ai) / Hermes Agent / OpenClaw
+
+See [usememra.com/install](https://usememra.com/install) for client-specific snippets.
+
+## What you get
+
+- **Flat-file memory** in `~/.memra/` — plain YAML, inspectable, greppable, diff-able
+- **MCP server** exposing `memra_add`, `memra_recall`, `memra_get`, `memra_list`, `memra_supersede`, `memra_history`, and more
+- **Local embeddings** via `sentence-transformers` — no OpenAI key required
+- **Sync to cloud** optional: `memra sync enable <namespace> --api-key memra_live_...`
+
+## Commands
+
+```bash
+memra mcp          # MCP server over stdio
+memra status       # verify server + list namespaces
+memra hooks install  # optional — auto-capture decisions/patterns as you work
+memra --help       # full CLI reference
+```
+
+## Docs + source
+
+- Install snippets and client configs: https://usememra.com/install
+- Memra Cloud (hosted EU): https://usememra.com
+- Source: https://github.com/vonsensey/memra (directory `memra-local/`)
+
+## License
+
+[BUSL-1.1](./LICENSE). Change Date 2030-04-17 — on that date the license auto-converts to Apache-2.0. Until then, personal and non-production use are unrestricted; commercial production use requires a separate license.

memra_local-0.2.0/README.md

@@ -0,0 +1,73 @@
+# memra-local
+
+Local-first memory server for AI agents. Offline, private, fast.
+
+`memra-local` gives your coding agent persistent memory that lives entirely on your machine — no account, no network, no data leaves the laptop. Works with Claude Code, Cursor, Zed, Droid, Hermes Agent, OpenClaw, and any MCP-compatible client.
+
+When you're ready to sync across devices or share with a team, a single command pushes your local namespace to [Memra Cloud](https://usememra.com). Same tools, same API, your choice.
+
+## Install
+
+```bash
+pip install memra-local
+memra mcp          # start the MCP server
+```
+
+Requires Python 3.10+.
+
+## Wire it into your editor
+
+### Claude Code / Cursor
+
+```json
+{
+  "mcpServers": {
+    "memra": {
+      "command": "memra",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### Zed
+
+```json
+{
+  "context_servers": {
+    "memra": {
+      "command": { "path": "memra", "args": ["mcp"] }
+    }
+  }
+}
+```
+
+### Droid (Factory.ai) / Hermes Agent / OpenClaw
+
+See [usememra.com/install](https://usememra.com/install) for client-specific snippets.
+
+## What you get
+
+- **Flat-file memory** in `~/.memra/` — plain YAML, inspectable, greppable, diff-able
+- **MCP server** exposing `memra_add`, `memra_recall`, `memra_get`, `memra_list`, `memra_supersede`, `memra_history`, and more
+- **Local embeddings** via `sentence-transformers` — no OpenAI key required
+- **Sync to cloud** optional: `memra sync enable <namespace> --api-key memra_live_...`
+
+## Commands
+
+```bash
+memra mcp          # MCP server over stdio
+memra status       # verify server + list namespaces
+memra hooks install  # optional — auto-capture decisions/patterns as you work
+memra --help       # full CLI reference
+```
+
+## Docs + source
+
+- Install snippets and client configs: https://usememra.com/install
+- Memra Cloud (hosted EU): https://usememra.com
+- Source: https://github.com/vonsensey/memra (directory `memra-local/`)
+
+## License
+
+[BUSL-1.1](./LICENSE). Change Date 2030-04-17 — on that date the license auto-converts to Apache-2.0. Until then, personal and non-production use are unrestricted; commercial production use requires a separate license.

memra_local-0.2.0/memra_local/__init__.py

@@ -0,0 +1,3 @@
+"""Memra Local — offline memory server for AI agents."""
+
+__version__ = "0.2.0"

memra_local-0.2.0/memra_local/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m memra_local`."""
+
+from memra_local.cli import cli
+
+if __name__ == "__main__":
+    cli()

memra_local-0.2.0/memra_local/app.py

@@ -0,0 +1,65 @@
+"""FastAPI application factory with lifespan for memra-local."""
+
+from __future__ import annotations
+
+from contextlib import asynccontextmanager
+from pathlib import Path
+from typing import AsyncIterator
+
+from fastapi import FastAPI
+
+from memra_local import __version__
+from memra_local.config import resolve_scope
+from memra_local.routes import bootstrap, memories, search
+from memra_local.services.factory import create_service
+
+
+def create_app(
+    scope: str = "auto",
+    storage_dir: Path | None = None,
+) -> FastAPI:
+    """Create and configure the FastAPI application.
+
+    Args:
+        scope: Storage scope -- "global", "project", or "auto".
+        storage_dir: Override storage directory (used by tests).
+
+    Returns:
+        Configured FastAPI app with service on app.state.service.
+    """
+    resolved_scope = resolve_scope(scope) if storage_dir is None else scope
+
+    # Use shared factory for service creation (same as MCP server)
+    service = create_service(scope=scope, storage_dir=storage_dir)
+
+    @asynccontextmanager
+    async def lifespan(app: FastAPI) -> AsyncIterator[None]:
+        """Index is already initialized by factory; just handle shutdown."""
+        yield
+        service.index.close()
+
+    app = FastAPI(
+        title="Memra Local",
+        version=__version__,
+        description="Local memory server for AI agents",
+        lifespan=lifespan,
+    )
+
+    # Store service on app state for route access
+    app.state.service = service
+
+    # Include routers with /v1 prefix
+    app.include_router(memories.router, prefix="/v1")
+    app.include_router(search.router, prefix="/v1")
+    app.include_router(bootstrap.router, prefix="/v1")
+
+    # Health endpoint (no prefix)
+    @app.get("/health")
+    def health():
+        return {
+            "status": "healthy",
+            "version": __version__,
+            "scope": resolved_scope,
+        }
+
+    return app