basemind 0.2.1__py3-none-any.whl

basemind/__init__.py

@@ -0,0 +1,5 @@
+"""
+basemind: Code-map MCP server + scanner — content-addressed, Fjall-backed inverted index over tree-sitter outlines.
+"""
+
+__version__ = "0.2.1"

basemind/cli.py

@@ -0,0 +1,15 @@
+"""CLI entry point for basemind."""
+
+import sys
+
+from .downloader import run_basemind
+
+
+def main():
+    """Main entry point for the CLI."""
+    args = sys.argv[1:]
+    run_basemind(args)
+
+
+if __name__ == "__main__":
+    main()

basemind/downloader.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+import os
+import platform
+import ssl
+import subprocess
+import sys
+import tempfile
+import tarfile
+import zipfile
+from pathlib import Path
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+
+import certifi
+
+
+def _platform_triple() -> str:
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    if system == "windows":
+        if machine in {"amd64", "x86_64"}:
+            return "x86_64-pc-windows-gnu"
+        if machine in {"x86", "i386", "i686"}:
+            raise RuntimeError("32-bit Windows is not supported")
+    elif system == "linux":
+        if machine in {"amd64", "x86_64"}:
+            return "x86_64-unknown-linux-gnu"
+        if machine in {"aarch64", "arm64"}:
+            return "aarch64-unknown-linux-gnu"
+    elif system == "darwin":
+        if machine in {"amd64", "x86_64"}:
+            return "x86_64-apple-darwin"
+        if machine in {"aarch64", "arm64"}:
+            return "aarch64-apple-darwin"
+
+    raise RuntimeError(f"Unsupported platform: {system} {machine}")
+
+
+def _python_version_to_tag(version: str) -> str:
+    if "rc" in version:
+        core, suffix = version.split("rc")
+        return f"{core}-rc.{suffix}"
+    return version
+
+
+def _asset(version: str) -> tuple[str, str]:
+    tag = _python_version_to_tag(version)
+    triple = _platform_triple()
+    ext = "zip" if "windows" in triple else "tar.gz"
+    url = (
+        f"https://github.com/Goldziher/basemind/releases/download/"
+        f"v{tag}/basemind-{triple}.{ext}"
+    )
+    return url, ext
+
+
+def _download(url: str, destination: Path) -> None:
+    request = Request(url, headers={"User-Agent": "basemind-python-wrapper"})
+    context = ssl.create_default_context(cafile=certifi.where())
+    try:
+        with urlopen(request, timeout=30, context=context) as response:
+            if response.status != 200:
+                raise RuntimeError(f"HTTP {response.status}: {response.reason}")
+            destination.write_bytes(response.read())
+    except URLError as exc:
+        raise RuntimeError(f"Failed to download binary: {exc}") from exc
+
+
+def _extract(archive: Path, ext: str, destination: Path) -> None:
+    if ext == "zip":
+        with zipfile.ZipFile(archive) as zf:
+            for name in zf.namelist():
+                if name.endswith("basemind") or name.endswith("basemind.exe"):
+                    with zf.open(name) as src, destination.open("wb") as dst:
+                        dst.write(src.read())
+                    return
+    else:
+        with tarfile.open(archive, "r:gz") as tar:
+            for member in tar.getmembers():
+                if member.name.endswith("basemind") or member.name.endswith("basemind.exe"):
+                    with tar.extractfile(member) as src, destination.open("wb") as dst:
+                        dst.write(src.read())
+                    return
+    raise RuntimeError("Binary not found in downloaded archive")
+
+
+def _cache_path(version: str) -> Path:
+    cache_dir = Path.home() / ".cache" / "basemind" / version
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    suffix = ".exe" if platform.system().lower() == "windows" else ""
+    return cache_dir / f"basemind{suffix}"
+
+
+def ensure_binary():
+    """Ensure the binary is available, downloading if necessary."""
+    from . import __version__
+
+    override = os.getenv("BASEMIND_BINARY")
+    if override:
+        return override
+
+    binary_path = _cache_path(__version__)
+    if binary_path.exists() and os.access(binary_path, os.X_OK):
+        return str(binary_path)
+
+    url, ext = _asset(__version__)
+    print(f"Downloading basemind binary v{__version__}...", file=sys.stderr)
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        archive_path = Path(tmpdir) / f"basemind.{ext}"
+        _download(url, archive_path)
+        _extract(archive_path, ext, binary_path)
+
+    if platform.system().lower() != "windows":
+        binary_path.chmod(0o755)
+
+    print("Binary downloaded successfully!", file=sys.stderr)
+    return str(binary_path)
+
+
+def run_basemind(args):
+    """Run the basemind binary with the given arguments."""
+    binary_path = ensure_binary()
+
+    try:
+        result = subprocess.run([binary_path] + args, check=False)
+        sys.exit(result.returncode)
+    except FileNotFoundError:
+        raise RuntimeError(f"Binary not found at {binary_path}")
+    except Exception as e:
+        raise RuntimeError(f"Failed to run basemind: {e}")

basemind-0.2.1.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.1
+Name: basemind
+Version: 0.2.1
+Summary: Full AI context layer over MCP — tree-sitter code-map, document RAG (PDF/Office/HTML/email + OCR + reranker), shared agent memory, on-demand web crawl, git history + blame + per-symbol diff. 300+ languages, 8 coding-agent harnesses, content-addressed Fjall + LanceDB.
+Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Goldziher/basemind
+Project-URL: Repository, https://github.com/Goldziher/basemind.git
+Project-URL: Issues, https://github.com/Goldziher/basemind/issues
+Keywords: mcp,agent-context,rag,code-map,tree-sitter
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: certifi>=2024.7.4
+
+# basemind
+
+Full AI context layer for coding agents — code-map, document RAG, shared memory, web crawl,
+git history. 300+ languages, one MCP server.
+
+<!-- markdownlint-disable-next-line MD013 -->
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Goldziher/basemind/blob/main/LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/basemind.svg)](https://pypi.org/project/basemind/)
+
+## Install
+
+```bash
+pip install basemind
+```
+
+On first invocation, the pre-compiled Rust binary for your platform (macOS, Linux, Windows;
+x86_64 + arm64) is downloaded from
+[GitHub Releases](https://github.com/Goldziher/basemind/releases) and cached under
+`~/.cache/basemind/<version>/`.
+
+Override the binary location with `BASEMIND_BINARY=/path/to/basemind`.
+
+## Quickstart
+
+```bash
+cd /path/to/your/repo
+basemind scan        # index the working tree
+basemind serve       # run the MCP stdio server
+```
+
+Wire `basemind serve` into Claude Code or any MCP client.
+
+## Full documentation
+
+See the [main README](https://github.com/Goldziher/basemind#readme) for complete docs,
+architecture, MCP tool reference, and per-harness setup instructions.
+
+## License
+
+[MIT](https://github.com/Goldziher/basemind/blob/main/LICENSE).

basemind-0.2.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+basemind/__init__.py,sha256=7q0OZVqcw3jrBWjRexj249ByXoFSbBtTRU80pPpxn1o,149
+basemind/cli.py,sha256=yKfxm1GBq9uZwTrLeNSDFZgdrFsOOGVVnHIJXTlWCv8,227
+basemind/downloader.py,sha256=6xf1PPkFmsoVIHJSaTdbGJyxiSuzAyAnsAZvNJ8s_js,4464
+basemind-0.2.1.dist-info/METADATA,sha256=cFAcyweYhJP-7n_oN2Os5kVk5mll_VTlqyNmdrcdsJk,2640
+basemind-0.2.1.dist-info/WHEEL,sha256=BNRMDyzLkkcmlv0J8ppDQkk2VED33SesJDynr9ED1gc,91
+basemind-0.2.1.dist-info/entry_points.txt,sha256=etoC-7zCcRjKT3Ie0sSzWI_cYUigtd2vk8dNfHIa_8A,47
+basemind-0.2.1.dist-info/top_level.txt,sha256=uAaKHxi1hnhqokG_Z6VD1T48e1vYcRzziZWf7nwu0a0,9
+basemind-0.2.1.dist-info/RECORD,,

basemind-0.2.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

basemind-0.2.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+basemind = basemind.cli:main

basemind-0.2.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+basemind