aether-cache 0.1.5__tar.gz → 0.1.7__tar.gz

{aether_cache-0.1.5 → aether_cache-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: aether-cache
-Version: 0.1.5
+Version: 0.1.7
 Summary: Shared memory for AI coding tools that stays true to your code.
 Project-URL: Homepage, https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/
 Project-URL: Repository, https://github.com/anishchugh05/Aether-Cache-Redis-Compatible-Vector-Store
@@ -13,12 +13,14 @@ Requires-Dist: mcp>=1.2
 Requires-Dist: redis>=5.0
 Description-Content-Type: text/markdown
 
-[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+[![Aether Cache: memory that stays true to your code](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/og-image.png)](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)
 
 # Aether Cache
 
 **Shared memory for AI coding tools that stays true to your code.**
 
+<!-- mcp-name: io.github.anishchugh05/aether-cache -->
+
 **[Website](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)** · **[PyPI](https://pypi.org/project/aether-cache/)**
 
 Claude Code, Cursor, and other AI tools each forget your project between sessions, and when they do remember things,
@@ -63,7 +65,14 @@ other tools ─┘   (Python: embeddings,│          memories, HNSW vector inde
 
 ## What it looks like
 
-A memory linked to a file, the file changes, and the next lookup catches it:
+The dashboard (`aether-cache ui`): memories whose files changed wait for a decision, with the file versions side by side.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-dark.png">
+  <img alt="The Aether Cache dashboard showing stale memories and a possible conflict" src="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-light.png">
+</picture>
+
+And from your AI tool's side, a memory linked to a file, the file changes, and the next lookup catches it:
 
 ```
 > remember("The database runs Postgres via docker compose", files=["docker-compose.yml"])
@@ -106,12 +115,26 @@ m1 retired; m3 replaces it.
 
 ## Quick start
 
-You need [**uv**](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`), which also takes
-care of Python for you. Then:
+One line installs everything and runs setup. On macOS or Linux:
+
+```sh
+curl -fsSL https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/install.sh | sh
+```
+
+On Windows (PowerShell):
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/anishchugh05/Aether-Cache-Redis-Compatible-Vector-Store/main/docs/install.ps1 | iex"
+```
+
+The installer ([install.sh](docs/install.sh), [install.ps1](docs/install.ps1)) gets [uv](https://docs.astral.sh/uv/) if you
+don't have it (uv brings Python), installs Aether Cache, and runs `aether-cache setup`. Prefer your own tools? Any of
+these works, followed by `aether-cache setup`:
 
 ```sh
 uv tool install aether-cache
-aether-cache setup
+pipx install aether-cache
+pip install aether-cache        # Python 3.10+
 ```
 
 `setup` starts the engine in the background, downloads the embedding model once (about 90 MB), and connects every
@@ -122,7 +145,7 @@ repo and try:
 
 Then start a new session and ask how to run the tests.
 
-The engine runs on Java 11+. If you have it, it's used. If you don't, `setup` downloads a private copy (about
+The engine runs on Java 11+. If you have it, it's used. If you don't, Aether Cache downloads a private copy (about
 50 MB) into `~/.aether-cache/java`, checks it against its published checksum, and uses it only for Aether Cache;
 nothing is installed system-wide, and `aether-cache uninstall` removes it.
 
@@ -203,6 +226,8 @@ A Redis-compatible server written from scratch in Java. It speaks RESP, so `redi
 [CodeCrafters "Build Your Own Redis"](https://codecrafters.io/challenges/redis) challenge; the vector index,
 persistence hardening, and the memory layer are my own additions.
 
+[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+
 ### Throughput vs. official Redis
 
 `redis-benchmark -t set,get`, 100K requests, 50 parallel clients, 3-byte values, same machine:
@@ -369,6 +394,18 @@ memory_mcp/calibrate.py      similarity calibration for duplicate/contradiction
 vector_bench.py              HNSW benchmark (writes results.json)
 crash_test.py                kill -9 crash-safety test
 ```
+
+## Releasing
+
+Bump the version in `pyproject.toml`, `aether_cache/__init__.py`, and `server.json`, commit, then:
+
+```sh
+git tag v0.1.7 && git push --tags
+```
+
+The [release workflow](.github/workflows/release.yml) checks the versions match, builds and smoke-tests the package,
+publishes it to PyPI and the MCP Registry, and creates the GitHub Release.
+
 ## License
 
 MIT. See [LICENSE](LICENSE).

{aether_cache-0.1.5 → aether_cache-0.1.7}/README.md

@@ -1,9 +1,11 @@
-[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+[![Aether Cache: memory that stays true to your code](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/og-image.png)](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)
 
 # Aether Cache
 
 **Shared memory for AI coding tools that stays true to your code.**
 
+<!-- mcp-name: io.github.anishchugh05/aether-cache -->
+
 **[Website](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)** · **[PyPI](https://pypi.org/project/aether-cache/)**
 
 Claude Code, Cursor, and other AI tools each forget your project between sessions, and when they do remember things,
@@ -48,7 +50,14 @@ other tools ─┘   (Python: embeddings,│          memories, HNSW vector inde
 
 ## What it looks like
 
-A memory linked to a file, the file changes, and the next lookup catches it:
+The dashboard (`aether-cache ui`): memories whose files changed wait for a decision, with the file versions side by side.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-dark.png">
+  <img alt="The Aether Cache dashboard showing stale memories and a possible conflict" src="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-light.png">
+</picture>
+
+And from your AI tool's side, a memory linked to a file, the file changes, and the next lookup catches it:
 
 ```
 > remember("The database runs Postgres via docker compose", files=["docker-compose.yml"])
@@ -91,12 +100,26 @@ m1 retired; m3 replaces it.
 
 ## Quick start
 
-You need [**uv**](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`), which also takes
-care of Python for you. Then:
+One line installs everything and runs setup. On macOS or Linux:
+
+```sh
+curl -fsSL https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/install.sh | sh
+```
+
+On Windows (PowerShell):
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/anishchugh05/Aether-Cache-Redis-Compatible-Vector-Store/main/docs/install.ps1 | iex"
+```
+
+The installer ([install.sh](docs/install.sh), [install.ps1](docs/install.ps1)) gets [uv](https://docs.astral.sh/uv/) if you
+don't have it (uv brings Python), installs Aether Cache, and runs `aether-cache setup`. Prefer your own tools? Any of
+these works, followed by `aether-cache setup`:
 
 ```sh
 uv tool install aether-cache
-aether-cache setup
+pipx install aether-cache
+pip install aether-cache        # Python 3.10+
 ```
 
 `setup` starts the engine in the background, downloads the embedding model once (about 90 MB), and connects every
@@ -107,7 +130,7 @@ repo and try:
 
 Then start a new session and ask how to run the tests.
 
-The engine runs on Java 11+. If you have it, it's used. If you don't, `setup` downloads a private copy (about
+The engine runs on Java 11+. If you have it, it's used. If you don't, Aether Cache downloads a private copy (about
 50 MB) into `~/.aether-cache/java`, checks it against its published checksum, and uses it only for Aether Cache;
 nothing is installed system-wide, and `aether-cache uninstall` removes it.
 
@@ -188,6 +211,8 @@ A Redis-compatible server written from scratch in Java. It speaks RESP, so `redi
 [CodeCrafters "Build Your Own Redis"](https://codecrafters.io/challenges/redis) challenge; the vector index,
 persistence hardening, and the memory layer are my own additions.
 
+[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+
 ### Throughput vs. official Redis
 
 `redis-benchmark -t set,get`, 100K requests, 50 parallel clients, 3-byte values, same machine:
@@ -354,6 +379,18 @@ memory_mcp/calibrate.py      similarity calibration for duplicate/contradiction
 vector_bench.py              HNSW benchmark (writes results.json)
 crash_test.py                kill -9 crash-safety test
 ```
+
+## Releasing
+
+Bump the version in `pyproject.toml`, `aether_cache/__init__.py`, and `server.json`, commit, then:
+
+```sh
+git tag v0.1.7 && git push --tags
+```
+
+The [release workflow](.github/workflows/release.yml) checks the versions match, builds and smoke-tests the package,
+publishes it to PyPI and the MCP Registry, and creates the GitHub Release.
+
 ## License
 
 MIT. See [LICENSE](LICENSE).

{aether_cache-0.1.5 → aether_cache-0.1.7}/aether_cache/__init__.py

@@ -1,3 +1,3 @@
 """Aether Cache: shared memory for AI coding tools that stays true to your code."""
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"

{aether_cache-0.1.5 → aether_cache-0.1.7}/aether_cache/engine.py

@@ -224,7 +224,7 @@ def start(wait: float = 60) -> str:
             upgraded = True
         if state == "other":
             raise EngineError(port_taken_message())
-        java, _ = find_java()
+        java = _java_or_download()
         note = _migrate_old_data()
         config.DATA_DIR.mkdir(parents=True, exist_ok=True)
         command = [java, "-Xmx1g", "-jar", str(JAR),
@@ -264,6 +264,31 @@ def start(wait: float = 60) -> str:
         raise EngineError(f"The engine didn't answer within {int(wait)} seconds. See {config.LOG_FILE}.")
 
 
+def _java_or_download() -> str:
+    """Java for starting the engine. If there isn't any, downloads Aether Cache's private copy, so the engine
+    also starts for people whose AI tool runs the server without `aether-cache setup` having run first.
+    Called while holding the start lock, so several sessions starting at once download it only once."""
+    try:
+        return find_java()[0]
+    except EngineError as missing:
+        if os.environ.get("AETHER_NO_JAVA_DOWNLOAD"):
+            raise
+        from . import javart
+        notice = (f"{str(missing).splitlines()[0]} Downloading a private copy of Java {javart.FEATURE_VERSION} "
+                  f"for Aether Cache into {javart.JAVA_DIR} (about 50 MB, only the first time).")
+        print(notice, file=sys.stderr, flush=True)  # stderr: stdout carries the MCP protocol
+        try:
+            with open(config.LOG_FILE, "a") as log:
+                log.write(f"\n{time.strftime('%Y-%m-%d %H:%M:%S')} {notice}\n")
+        except OSError:
+            pass
+        try:
+            javart.download(progress=lambda done, total: None)
+        except javart.JavaDownloadError as e:
+            raise EngineError(f"{str(missing).splitlines()[0]}\n{e}")
+        return find_java()[0]
+
+
 def ensure_running() -> None:
     if probe() != "aether" or needs_upgrade():
         start()

{aether_cache-0.1.5 → aether_cache-0.1.7}/aether_cache/server.py

@@ -16,7 +16,7 @@ from typing import List, Optional
 
 import redis
 
-from . import config, engine
+from . import __version__, config, engine
 
 try:
     from mcp.server.mcpserver import MCPServer  # mcp 2.x
@@ -39,10 +39,14 @@ INSTRUCTIONS = (
     "replace_memory."
 )
 
-mcp = MCPServer(
-    "aether-cache",
-    instructions=INSTRUCTIONS,
-)
+try:
+    mcp = MCPServer("aether-cache", instructions=INSTRUCTIONS, version=__version__)
+except Exception:  # mcp 1.x has no version argument; set it on the underlying server instead
+    mcp = MCPServer("aether-cache", instructions=INSTRUCTIONS)
+    try:
+        mcp._mcp_server.version = __version__
+    except AttributeError:
+        pass
 
 def quiet_libraries() -> None:
     """Hides the download libraries' request logs, warnings and progress bars, which otherwise flood the

{aether_cache-0.1.5 → aether_cache-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "aether-cache"
-version = "0.1.5"
+version = "0.1.7"
 description = "Shared memory for AI coding tools that stays true to your code."
 readme = "README.md"
 requires-python = ">=3.10"