ememdev 0.0.9__tar.gz

ememdev-0.0.9/.gitignore

@@ -0,0 +1,83 @@
+# Rust build artefacts
+/target/
+**/target/
+
+# Local persisted data + secrets
+/var/
+**/var/emem/
+**/var/demos/
+*.secret.b32
+identity.secret.b32
+.cloudflared/
+acme.cache/
+tls/
+# Runtime cruft — when EMEM_DATA=:memory: is misinterpreted as a path
+# string, a literal :memory: directory is created. Untracked but
+# silenced from `git status` so it doesn't read as repo state.
+/:memory:/
+**/:memory:/
+
+# Editor / OS
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Node / Vite — the old TS/Vite SPA at repo root was retired in 0.0.6;
+# the live https://emem.dev is served by the Rust `emem-server` binary.
+# These patterns prevent the scaffolding from sneaking back in at root.
+# sdks/emem-ts/ has its own legitimate package.json / tsconfig.json /
+# src/ — those are NOT matched here because patterns are anchored to /.
+node_modules/
+dist/
+dist-server/
+.parcel-cache/
+/index.html
+/package.json
+/package-lock.json
+/vite.config.ts
+/tsconfig.json
+/tsconfig.server.json
+/src/
+/server/
+/tests/*.test.ts
+
+# Artifacts (screenshots, generated images) — keep folder, ignore contents
+artifacts/*
+!artifacts/.gitkeep
+
+# Python ad-hoc tools
+__pycache__/
+*.pyc
+.venv/
+
+# Local Claude / IDE state
+.claude/
+CLAUDE.md
+registry_claude.md
+
+# Env files
+.env
+.env.*
+!.env.example
+
+# Logs + coverage
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+coverage/
+.nyc_output/
+notes/
+
+# fastembed-rs ONNX model cache (HF hub mirror, ~400 MB)
+.fastembed_cache/
+scripts/eval/results/q*.json
+
+# mdbook output for the /docs/ site. The book is built at deploy/CI time
+# (see scripts/redeploy.sh and .github/workflows/ci.yml) and baked into
+# the binary via `include_dir!("docs/book")`. Committing it would churn the
+# repo every docs edit (hashed asset filenames) and add ~5 MB; build it
+# fresh on each CI run instead.
+docs/book/

ememdev-0.0.9/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: ememdev
+Version: 0.0.9
+Summary: Python client for emem.dev, the agent-native Earth memory protocol
+Project-URL: Homepage, https://emem.dev
+Project-URL: Repository, https://github.com/Vortx-AI/emem
+Project-URL: Documentation, https://emem.dev/agents.md
+Project-URL: Issues, https://github.com/Vortx-AI/emem/issues
+Author-email: Vortx AI Private Limited <avijeet@vortx.ai>
+License: Apache-2.0
+Keywords: content-addressed,earth-observation,ed25519,geospatial,mcp,satellite
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software 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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.9
+Requires-Dist: httpx<1.0,>=0.27
+Description-Content-Type: text/markdown
+
+# ememdev: Python client for emem.dev
+
+<!-- mcp-name: io.github.Vortx-AI/emem -->
+
+Thin, typed Python client for the [emem.dev](https://emem.dev) Earth memory
+protocol. Wraps the public REST surface (96 documented paths, 93 under
+`/v1/*`) in a single `Client` class that returns parsed JSON verbatim. Every
+ed25519-signed receipt and content-addressed CID is preserved for
+citation and offline verification.
+
+## Install
+
+```bash
+pip install ememdev
+```
+
+The distribution is named `ememdev`; the import package is `emem` (so
+`pip install ememdev`, then `from emem import Client`). To work from a
+checkout instead:
+
+```bash
+pip install -e sdks/emem-py
+```
+
+Requires Python 3.9+. The only runtime dependency is
+[`httpx`](https://www.python-httpx.org/).
+
+## Quick start
+
+```python
+from emem import Client
+
+with Client() as em:
+    cell = em.locate("Mount Fuji")["cell64"]
+    facts = em.recall(cell, bands=["copdem30m.elevation_mean"])
+    print(facts["facts"][0]["value"])
+```
+
+## Async
+
+```python
+import asyncio
+from emem import AsyncClient
+
+async def main() -> None:
+    async with AsyncClient() as em:
+        out = await em.ask("How tall is Mount Everest?")
+        print(out["answer"])
+
+asyncio.run(main())
+```
+
+## Configuration
+
+| Env var               | Default              | Effect                                      |
+|-----------------------|----------------------|---------------------------------------------|
+| `EMEM_BASE_URL`       | `https://emem.dev`   | Responder root; point at a self-hosted node |
+| `EMEM_TIMEOUT_SECS`   | `180`                | HTTP timeout (matches gateway timeout)      |
+
+You can also pass `base_url=` and `timeout=` directly to the constructor.
+
+## Surface coverage
+
+Geocoder + read primitives, physics solvers, boring lat/lng shortcuts, and
+introspection — see the inline docstring on `emem.client` for the full
+endpoint → method mapping.
+
+## Receipts
+
+Every non-introspection response carries a `receipt` block with:
+
+- `responder_pubkey` (ed25519 base32-nopad-lowercase)
+- `signature_b32` (ed25519 over the canonical CBOR preimage)
+- `merkle_root` (BLAKE3 over the fact CIDs)
+- `fact_cids[]` (the BLAKE3 CIDs of every fact returned)
+
+To cite an answer: quote `receipt.fact_cids[0]` and the responder pubkey.
+The signature can be verified offline against the public key at
+`https://emem.dev/.well-known/emem.json`; no callback to the responder is
+required.
+
+## License
+
+Apache-2.0. Same as the upstream protocol.

ememdev-0.0.9/README.md

@@ -0,0 +1,84 @@
+# ememdev: Python client for emem.dev
+
+<!-- mcp-name: io.github.Vortx-AI/emem -->
+
+Thin, typed Python client for the [emem.dev](https://emem.dev) Earth memory
+protocol. Wraps the public REST surface (96 documented paths, 93 under
+`/v1/*`) in a single `Client` class that returns parsed JSON verbatim. Every
+ed25519-signed receipt and content-addressed CID is preserved for
+citation and offline verification.
+
+## Install
+
+```bash
+pip install ememdev
+```
+
+The distribution is named `ememdev`; the import package is `emem` (so
+`pip install ememdev`, then `from emem import Client`). To work from a
+checkout instead:
+
+```bash
+pip install -e sdks/emem-py
+```
+
+Requires Python 3.9+. The only runtime dependency is
+[`httpx`](https://www.python-httpx.org/).
+
+## Quick start
+
+```python
+from emem import Client
+
+with Client() as em:
+    cell = em.locate("Mount Fuji")["cell64"]
+    facts = em.recall(cell, bands=["copdem30m.elevation_mean"])
+    print(facts["facts"][0]["value"])
+```
+
+## Async
+
+```python
+import asyncio
+from emem import AsyncClient
+
+async def main() -> None:
+    async with AsyncClient() as em:
+        out = await em.ask("How tall is Mount Everest?")
+        print(out["answer"])
+
+asyncio.run(main())
+```
+
+## Configuration
+
+| Env var               | Default              | Effect                                      |
+|-----------------------|----------------------|---------------------------------------------|
+| `EMEM_BASE_URL`       | `https://emem.dev`   | Responder root; point at a self-hosted node |
+| `EMEM_TIMEOUT_SECS`   | `180`                | HTTP timeout (matches gateway timeout)      |
+
+You can also pass `base_url=` and `timeout=` directly to the constructor.
+
+## Surface coverage
+
+Geocoder + read primitives, physics solvers, boring lat/lng shortcuts, and
+introspection — see the inline docstring on `emem.client` for the full
+endpoint → method mapping.
+
+## Receipts
+
+Every non-introspection response carries a `receipt` block with:
+
+- `responder_pubkey` (ed25519 base32-nopad-lowercase)
+- `signature_b32` (ed25519 over the canonical CBOR preimage)
+- `merkle_root` (BLAKE3 over the fact CIDs)
+- `fact_cids[]` (the BLAKE3 CIDs of every fact returned)
+
+To cite an answer: quote `receipt.fact_cids[0]` and the responder pubkey.
+The signature can be verified offline against the public key at
+`https://emem.dev/.well-known/emem.json`; no callback to the responder is
+required.
+
+## License
+
+Apache-2.0. Same as the upstream protocol.

ememdev-0.0.9/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling>=1.18"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ememdev"
+version = "0.0.9"
+description = "Python client for emem.dev, the agent-native Earth memory protocol"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Apache-2.0" }
+authors = [
+    { name = "Vortx AI Private Limited", email = "avijeet@vortx.ai" },
+]
+keywords = [
+    "earth-observation",
+    "geospatial",
+    "satellite",
+    "mcp",
+    "ed25519",
+    "content-addressed",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: Apache Software 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",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: GIS",
+]
+dependencies = [
+    "httpx>=0.27,<1.0",
+]
+
+[project.urls]
+Homepage = "https://emem.dev"
+Repository = "https://github.com/Vortx-AI/emem"
+Documentation = "https://emem.dev/agents.md"
+Issues = "https://github.com/Vortx-AI/emem/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/emem"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/emem", "README.md", "LICENSE"]