elesync 1.1.2__tar.gz → 1.2.0__tar.gz

{elesync-1.1.2 → elesync-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elesync
-Version: 1.1.2
+Version: 1.2.0
 Summary: Local-first, MCP-native unified memory vault — your AI memory as files you own, shared across every model.
 Author: Alphanymous
 License: MIT
@@ -44,9 +44,9 @@ Dynamic: license-file
 
 # 🐘 EleSync
 
-### Stop re-explaining yourself to every AI. One memory, every model.
+### Tired of re-explaining yourself to every AI? I bet you are, that's why we created EleSync, a One command setup memory vault, nicely encrypted, accessible to continue your conversations without repeating yourself to every model.
 
-🔰 **Not a developer?** Read the [plain-English setup guide](SETUP.md) — no coding knowledge needed, ~10 minutes.
+🔰 **You're not a developer?** Perfect — EleSync is designed for regular people first. Read the **[plain-English setup guide](SETUP.md)** — covers everything from first install to USB vault, step by step. ~10 minutes, no coding knowledge needed.
 
 <p align="center">
   <img src="Elesyncdemo.gif" alt="EleSync demo" width="640">
@@ -84,7 +84,7 @@ pip install "elesync[watch]"
 ele watch --autostart        # runs in the background from now on
 ```
 
-**Stable at v1.0** — a 134-test suite, CI across Python 3.10–3.14 (including a dev-extras job
+**Stable at v1.2** — a 134-test suite, CI across Python 3.10–3.14 (including a dev-extras job
 covering encryption and real-model semantic recall) plus ruff lint/format and mypy type-checking,
 and a public surface (CLI commands, MCP tools, vault layout, export format) you can build on
 without breakage inside 1.x. See the [CHANGELOG](CHANGELOG.md) for the full history.
@@ -128,7 +128,7 @@ leave open is the wedge here:
 | Live read **+ write back** | within app | ✗ static file | ✓ |
 | Infrastructure | crypto/wallet | browser only | ✓ zero — files + SQLite |
 
-"Eco-friendly and easy" = no server, no database to run, no crypto. Markdown + SQLite.
+"Eco-friendly and easy" = no server, no database to run, no blockchain/wallet. Markdown + SQLite.
 
 ## Architecture
 
@@ -388,6 +388,59 @@ ele conflicts
 `fact`s that look like they're about the same thing but differ — so treat results as *candidates to
 review*, not verdicts. EleSync only ever **surfaces**; you resolve with `ele forget <id>`.
 
+## Portable USB vault (carry your memory anywhere)
+
+Plug in a USB drive, run one command, and your encrypted AI memory goes with you everywhere.
+On any machine with Python, `python RUN_ME.py` installs EleSync and connects it to Claude — no
+prior knowledge needed.
+
+```bash
+pip install "elesync[mcp,encryption]"
+
+# One-time setup on your USB drive
+ele usb install /Volumes/MyUSB          # macOS
+ele usb install E:\\                    # Windows
+ele usb install /media/myusb            # Linux
+# Enter a passphrase when prompted — this encrypts everything on the drive
+
+# Later: import your AI memories onto the drive
+ele --vault /Volumes/MyUSB/EleSyncVault import chatgpt_memory.json --source chatgpt
+ele --vault /Volumes/MyUSB/EleSyncVault import claude_export.json  --source claude
+ele --vault /Volumes/MyUSB/EleSyncVault import gemini_memory.json  --source gemini
+
+# Connect to Claude Desktop (on any machine)
+ele usb attach /Volumes/MyUSB           # prompts for passphrase, wires Claude Desktop
+# → Fully quit and reopen Claude Desktop
+
+# Before unplugging
+ele usb detach /Volumes/MyUSB           # removes Claude Desktop entry
+ele usb eject  /Volumes/MyUSB           # safe-eject
+
+# Other commands
+ele usb list                            # see all removable drives
+ele usb status /Volumes/MyUSB          # check vault health & memory count
+```
+
+**On a new machine** — plug in the drive and run:
+
+```bash
+python /Volumes/MyUSB/RUN_ME.py
+```
+
+That's it. `RUN_ME.py` is a self-contained script the drive carries with it: it installs
+EleSync via pip (if needed) and wires the USB vault into Claude Desktop — no prior knowledge
+of pip or MCP required.
+
+**Security model** — USB vaults are *always* encrypted (unlike the main vault where encryption
+is opt-in). Your passphrase is the only thing that unlocks the vault; a lost or stolen drive
+exposed nothing without it. The same XSalsa20-Poly1305 + argon2id encryption used by
+`ele encrypt` is applied automatically at install time.
+
+> The USB vault is a standard EleSync vault at `<drive>/EleSyncVault`. You can run any normal
+> `ele` command against it by passing `--vault <drive>/EleSyncVault`. Nothing is synced
+> automatically between the USB vault and your main vault — use `ele export` + `ele import` to
+> move memories between them.
+
 ## Sync across devices
 
 Your vault is **just a folder** (`notes/*.md` + a small `vault.json`), so sync it however you
@@ -508,6 +561,8 @@ file into your own vault sidesteps that entirely.
 
 ## Roadmap (the honest next 20%)
 
+<!-- NOTE: USB portable vault landed in v1.2.0 — removed from roadmap -->
+
 1. **Semantic recall** — ✅ landed (optional `[semantic]` extra: local ONNX embeddings,
    hybrid keyword+vector ranking — see above). Next: semantic *dedup* (near-duplicate
    detection), and pgvector/sqlite-vec if a vault ever outgrows brute-force cosine.

{elesync-1.1.2 → elesync-1.2.0}/README.md

@@ -4,9 +4,9 @@
 
 # 🐘 EleSync
 
-### Stop re-explaining yourself to every AI. One memory, every model.
+### Tired of re-explaining yourself to every AI? I bet you are, that's why we created EleSync, a One command setup memory vault, nicely encrypted, accessible to continue your conversations without repeating yourself to every model.
 
-🔰 **Not a developer?** Read the [plain-English setup guide](SETUP.md) — no coding knowledge needed, ~10 minutes.
+🔰 **You're not a developer?** Perfect — EleSync is designed for regular people first. Read the **[plain-English setup guide](SETUP.md)** — covers everything from first install to USB vault, step by step. ~10 minutes, no coding knowledge needed.
 
 <p align="center">
   <img src="Elesyncdemo.gif" alt="EleSync demo" width="640">
@@ -44,7 +44,7 @@ pip install "elesync[watch]"
 ele watch --autostart        # runs in the background from now on
 ```
 
-**Stable at v1.0** — a 134-test suite, CI across Python 3.10–3.14 (including a dev-extras job
+**Stable at v1.2** — a 134-test suite, CI across Python 3.10–3.14 (including a dev-extras job
 covering encryption and real-model semantic recall) plus ruff lint/format and mypy type-checking,
 and a public surface (CLI commands, MCP tools, vault layout, export format) you can build on
 without breakage inside 1.x. See the [CHANGELOG](CHANGELOG.md) for the full history.
@@ -88,7 +88,7 @@ leave open is the wedge here:
 | Live read **+ write back** | within app | ✗ static file | ✓ |
 | Infrastructure | crypto/wallet | browser only | ✓ zero — files + SQLite |
 
-"Eco-friendly and easy" = no server, no database to run, no crypto. Markdown + SQLite.
+"Eco-friendly and easy" = no server, no database to run, no blockchain/wallet. Markdown + SQLite.
 
 ## Architecture
 
@@ -348,6 +348,59 @@ ele conflicts
 `fact`s that look like they're about the same thing but differ — so treat results as *candidates to
 review*, not verdicts. EleSync only ever **surfaces**; you resolve with `ele forget <id>`.
 
+## Portable USB vault (carry your memory anywhere)
+
+Plug in a USB drive, run one command, and your encrypted AI memory goes with you everywhere.
+On any machine with Python, `python RUN_ME.py` installs EleSync and connects it to Claude — no
+prior knowledge needed.
+
+```bash
+pip install "elesync[mcp,encryption]"
+
+# One-time setup on your USB drive
+ele usb install /Volumes/MyUSB          # macOS
+ele usb install E:\\                    # Windows
+ele usb install /media/myusb            # Linux
+# Enter a passphrase when prompted — this encrypts everything on the drive
+
+# Later: import your AI memories onto the drive
+ele --vault /Volumes/MyUSB/EleSyncVault import chatgpt_memory.json --source chatgpt
+ele --vault /Volumes/MyUSB/EleSyncVault import claude_export.json  --source claude
+ele --vault /Volumes/MyUSB/EleSyncVault import gemini_memory.json  --source gemini
+
+# Connect to Claude Desktop (on any machine)
+ele usb attach /Volumes/MyUSB           # prompts for passphrase, wires Claude Desktop
+# → Fully quit and reopen Claude Desktop
+
+# Before unplugging
+ele usb detach /Volumes/MyUSB           # removes Claude Desktop entry
+ele usb eject  /Volumes/MyUSB           # safe-eject
+
+# Other commands
+ele usb list                            # see all removable drives
+ele usb status /Volumes/MyUSB          # check vault health & memory count
+```
+
+**On a new machine** — plug in the drive and run:
+
+```bash
+python /Volumes/MyUSB/RUN_ME.py
+```
+
+That's it. `RUN_ME.py` is a self-contained script the drive carries with it: it installs
+EleSync via pip (if needed) and wires the USB vault into Claude Desktop — no prior knowledge
+of pip or MCP required.
+
+**Security model** — USB vaults are *always* encrypted (unlike the main vault where encryption
+is opt-in). Your passphrase is the only thing that unlocks the vault; a lost or stolen drive
+exposed nothing without it. The same XSalsa20-Poly1305 + argon2id encryption used by
+`ele encrypt` is applied automatically at install time.
+
+> The USB vault is a standard EleSync vault at `<drive>/EleSyncVault`. You can run any normal
+> `ele` command against it by passing `--vault <drive>/EleSyncVault`. Nothing is synced
+> automatically between the USB vault and your main vault — use `ele export` + `ele import` to
+> move memories between them.
+
 ## Sync across devices
 
 Your vault is **just a folder** (`notes/*.md` + a small `vault.json`), so sync it however you
@@ -468,6 +521,8 @@ file into your own vault sidesteps that entirely.
 
 ## Roadmap (the honest next 20%)
 
+<!-- NOTE: USB portable vault landed in v1.2.0 — removed from roadmap -->
+
 1. **Semantic recall** — ✅ landed (optional `[semantic]` extra: local ONNX embeddings,
    hybrid keyword+vector ranking — see above). Next: semantic *dedup* (near-duplicate
    detection), and pgvector/sqlite-vec if a vault ever outgrows brute-force cosine.

{elesync-1.1.2 → elesync-1.2.0}/elesync/__init__.py

@@ -1,12 +1,12 @@
-"""elesync — a local-first, MCP-native unified elesync.
-
-One vault on your disk. Every AI reads from and writes to it over MCP.
-"""
-
-from . import normalize
-from .models import MEMORY_TYPES, MemoryItem
-from .service import MemoryService
-from .store import MemoryStore
-
-__all__ = ["MemoryItem", "MEMORY_TYPES", "MemoryStore", "MemoryService", "normalize"]
-__version__ = "1.1.2"
+"""elesync — a local-first, MCP-native unified elesync.
+
+One vault on your disk. Every AI reads from and writes to it over MCP.
+"""
+
+from . import normalize
+from .models import MEMORY_TYPES, MemoryItem
+from .service import MemoryService
+from .store import MemoryStore
+
+__all__ = ["MemoryItem", "MEMORY_TYPES", "MemoryStore", "MemoryService", "normalize"]
+__version__ = "1.2.0"