sarvam-cli-app 1.17.13__py3-none-any.whl

sarvam_cli/__init__.py

@@ -0,0 +1,7 @@
+"""Thin pip wrapper for the Sarvam CLI native binary.
+
+The real product is the platform-native binary published to GitHub Releases;
+this package downloads it on first run and launches it.
+"""
+
+__version__ = "1.17.13"

sarvam_cli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

sarvam_cli/cli.py

@@ -0,0 +1,30 @@
+"""Entry point: ensure the native binary is present, then hand over to it."""
+
+import os
+import signal
+import subprocess
+import sys
+
+from .download import DownloadError, ensure_binary
+
+
+def main():
+    try:
+        binary = ensure_binary()
+    except DownloadError as err:
+        print("sarvam-cli: {}".format(err), file=sys.stderr)
+        sys.exit(1)
+
+    args = [binary] + sys.argv[1:]
+    if os.name == "posix":
+        # Replace this process so signals, exit codes, and TTY behavior all
+        # belong to the native binary.
+        os.execv(binary, args)
+    # Windows: no execv semantics — relay via subprocess. Ignore Ctrl+C in the
+    # parent so the child owns interrupt handling.
+    signal.signal(signal.SIGINT, signal.SIG_IGN)
+    sys.exit(subprocess.run(args).returncode)
+
+
+if __name__ == "__main__":
+    main()

sarvam_cli/download.py

@@ -0,0 +1,214 @@
+"""Fetch the platform-native Sarvam CLI binary from GitHub Releases.
+
+Python port of npm/install.mjs. Asset names and the release layout are fixed
+by .github/workflows/release.yml, so the candidate scheme here must match it:
+opencode-{platform}-{arch}{variant}{libc}{ext}.
+
+Unlike the npm wrapper (which writes into the package dir at postinstall),
+the binary is cached in a user-writable directory because site-packages may
+be root-owned.
+"""
+
+import hashlib
+import os
+import platform
+import shutil
+import subprocess
+import sys
+import tarfile
+import tempfile
+import urllib.error
+import urllib.request
+import zipfile
+
+from . import __version__
+
+REPO = "prashlkam/Sarvam-CLI"
+SUPPORTED = {"linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "windows-x64"}
+
+
+class DownloadError(Exception):
+    pass
+
+
+def _os_name():
+    if sys.platform.startswith("linux"):
+        return "linux"
+    if sys.platform == "darwin":
+        return "darwin"
+    if sys.platform in ("win32", "cygwin"):
+        return "windows"
+    return sys.platform
+
+
+def _arch():
+    machine = platform.machine().lower()
+    if machine in ("x86_64", "amd64"):
+        return "x64"
+    if machine in ("aarch64", "arm64"):
+        return "arm64"
+    return machine
+
+
+def _is_musl():
+    if _os_name() != "linux":
+        return False
+    if os.path.exists("/etc/alpine-release"):
+        return True
+    try:
+        proc = subprocess.run(
+            ["ldd", "--version"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+        )
+        return "musl" in proc.stdout.lower()
+    except OSError:
+        return False
+
+
+def _binary_name():
+    return "sarvam-cli.exe" if _os_name() == "windows" else "sarvam-cli"
+
+
+def _cache_dir():
+    if _os_name() == "windows":
+        base = os.environ.get("LOCALAPPDATA") or os.path.expanduser("~\\AppData\\Local")
+    else:
+        base = os.environ.get("XDG_CACHE_HOME") or os.path.expanduser("~/.cache")
+    return os.path.join(base, "sarvam-cli")
+
+
+def _candidates(os_name, arch):
+    ext = ".tar.gz" if os_name == "linux" else ".zip"
+    variants = ["", "-baseline"] if arch == "x64" else [""]
+    libcs = ["-musl"] if os_name == "linux" and _is_musl() else [""]
+    return [
+        "opencode-{}-{}{}{}{}".format(os_name, arch, variant, libc, ext)
+        for libc in libcs
+        for variant in variants
+    ]
+
+
+def _fetch_checksums():
+    """Return {asset_name: sha256} from the release's checksums.txt, or {} if unavailable."""
+    url = "https://github.com/{}/releases/download/v{}/checksums.txt".format(REPO, __version__)
+    try:
+        with urllib.request.urlopen(url, timeout=30) as res:
+            text = res.read().decode("utf-8", "replace")
+    except (urllib.error.URLError, OSError):
+        return {}
+    sums = {}
+    for line in text.splitlines():
+        parts = line.split()
+        if len(parts) == 2:
+            sums[parts[1]] = parts[0]
+    return sums
+
+
+def _extract_binary(archive_path, tmp_dir):
+    """Extract the archive into tmp_dir and return the path to the binary, or None."""
+    if archive_path.endswith(".tar.gz"):
+        with tarfile.open(archive_path, "r:gz") as tf:
+            try:
+                tf.extractall(tmp_dir, filter="data")
+            except TypeError:  # Python < 3.12: no filter= kwarg
+                tf.extractall(tmp_dir)
+    else:
+        with zipfile.ZipFile(archive_path) as zf:
+            zf.extractall(tmp_dir)
+    binary = _binary_name()
+    for root, _dirs, files in os.walk(tmp_dir):
+        if binary in files:
+            return os.path.join(root, binary)
+    return None
+
+
+def _try_download(asset, dest, checksums):
+    url = "https://github.com/{}/releases/download/v{}/{}".format(REPO, __version__, asset)
+    tmp_dir = tempfile.mkdtemp(prefix="sarvam-cli-")
+    try:
+        archive_path = os.path.join(tmp_dir, asset)
+        try:
+            with urllib.request.urlopen(url, timeout=60) as res, open(archive_path, "wb") as out:
+                shutil.copyfileobj(res, out)
+        except (urllib.error.URLError, OSError):
+            return False
+
+        expected = checksums.get(asset)
+        if expected:
+            digest = hashlib.sha256()
+            with open(archive_path, "rb") as f:
+                for chunk in iter(lambda: f.read(1 << 20), b""):
+                    digest.update(chunk)
+            if digest.hexdigest() != expected:
+                print("sarvam-cli: checksum mismatch for {}, skipping".format(asset), file=sys.stderr)
+                return False
+
+        found = _extract_binary(archive_path, tmp_dir)
+        if not found:
+            return False
+
+        dest_dir = os.path.dirname(dest)
+        os.makedirs(dest_dir, exist_ok=True)
+        # Stage next to the destination so os.replace() is atomic (same filesystem),
+        # which keeps concurrent first-runs from seeing a half-written binary.
+        fd, staged = tempfile.mkstemp(prefix=".sarvam-cli-", dir=dest_dir)
+        os.close(fd)
+        shutil.move(found, staged)
+        if _os_name() != "windows":
+            os.chmod(staged, 0o755)
+        os.replace(staged, dest)
+        return True
+    finally:
+        shutil.rmtree(tmp_dir, ignore_errors=True)
+
+
+def _cleanup_old_versions(cache_root, current):
+    try:
+        entries = os.listdir(cache_root)
+    except OSError:
+        return
+    for entry in entries:
+        if entry.startswith("v") and entry != current:
+            shutil.rmtree(os.path.join(cache_root, entry), ignore_errors=True)
+
+
+def ensure_binary():
+    """Return the path to the native binary, downloading it on first run."""
+    override = os.environ.get("SARVAM_CLI_BINARY")
+    if override:
+        if not os.path.exists(override):
+            raise DownloadError("SARVAM_CLI_BINARY points to a missing file: {}".format(override))
+        return override
+
+    cache_root = _cache_dir()
+    version_dir = "v{}".format(__version__)
+    dest = os.path.join(cache_root, version_dir, _binary_name())
+    if os.path.exists(dest):
+        return dest
+
+    os_name, arch = _os_name(), _arch()
+    if "{}-{}".format(os_name, arch) not in SUPPORTED:
+        raise DownloadError(
+            "unsupported platform {}-{}. "
+            "See https://github.com/{}/releases".format(os_name, arch, REPO)
+        )
+
+    print(
+        "sarvam-cli: downloading native binary v{} (first run only)...".format(__version__),
+        file=sys.stderr,
+    )
+    checksums = _fetch_checksums()
+    for asset in _candidates(os_name, arch):
+        if _try_download(asset, dest, checksums):
+            _cleanup_old_versions(cache_root, version_dir)
+            return dest
+
+    raise DownloadError(
+        "could not download a binary for {}-{} (v{}). "
+        "Check your network (HTTPS_PROXY is honored), or download manually from "
+        "https://github.com/{}/releases and point SARVAM_CLI_BINARY at it.".format(
+            os_name, arch, __version__, REPO
+        )
+    )

sarvam_cli_app-1.17.13.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: sarvam-cli-app
+Version: 1.17.13
+Summary: Sarvam CLI — an AI coding agent for the terminal, powered by Sarvam AI. A fork of opencode.
+Project-URL: Homepage, https://github.com/prashlkam/Sarvam-CLI
+Project-URL: Repository, https://github.com/prashlkam/Sarvam-CLI
+Project-URL: Issues, https://github.com/prashlkam/Sarvam-CLI/issues
+Author: Prashanth Kamath
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,coding-assistant,opencode,sarvam
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Sarvam CLI (pip wrapper)
+
+Sarvam CLI — an AI coding agent for the terminal, powered by Sarvam AI. A fork
+of [opencode](https://github.com/sst/opencode).
+
+This package is a thin launcher: the first time you run `sarvam-cli` it
+downloads the platform-native binary (~55 MB) for your OS/architecture from
+the matching [GitHub Release](https://github.com/prashlkam/Sarvam-CLI/releases)
+and caches it under `~/.cache/sarvam-cli` (or `%LOCALAPPDATA%\sarvam-cli` on
+Windows). Subsequent runs start instantly.
+
+## Install
+
+```bash
+# pipx (recommended — this is an application, not a library)
+pipx install sarvam-cli-app
+
+# or plain pip
+pip install sarvam-cli-app
+```
+
+Both the `sarvam-cli` and `sarvam` commands are installed.
+
+> **Note:** the npm package (`npm install -g sarvam-cli`) is an equivalent
+> wrapper over the same binary — install one or the other, not both.
+
+## Usage
+
+```bash
+sarvam-cli            # start the agent in the current directory
+sarvam-cli --version
+```
+
+- Supported platforms: linux-x64, linux-arm64 (glibc and musl), darwin-x64,
+  darwin-arm64, windows-x64.
+- Set `SARVAM_CLI_BINARY=/path/to/sarvam-cli` to skip the download and use your
+  own binary (air-gapped installs, local builds).
+- Corporate proxy? The standard `HTTPS_PROXY` environment variable is honored.
+
+Project home: https://github.com/prashlkam/Sarvam-CLI

sarvam_cli_app-1.17.13.dist-info/RECORD

@@ -0,0 +1,9 @@
+sarvam_cli/__init__.py,sha256=SRnJOuKTbIeTVQjwCp-wpUo1ShMKzLp0Xuh39n3qSUo,217
+sarvam_cli/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+sarvam_cli/cli.py,sha256=84_TkfPUM0wAy9goLrCRBID3V3yCbwO-LOqSZ2Ti1yM,830
+sarvam_cli/download.py,sha256=gxV0YXSvwB9pel_OEqp5I4rkRtb6TkjXCr_2m_iBFLk,6923
+sarvam_cli_app-1.17.13.dist-info/METADATA,sha256=OuFvNMuCMSuVWCmTG_v5avicKAK_mHs88u1iyErLAd8,2160
+sarvam_cli_app-1.17.13.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+sarvam_cli_app-1.17.13.dist-info/entry_points.txt,sha256=YjprpZ-AOAHxLn7oUfrNQ8J_FVdTPhuDwLQEfPYvVRc,80
+sarvam_cli_app-1.17.13.dist-info/licenses/LICENSE,sha256=Yl8PYZEz-Ju7sqvjc2lhPfoYheuh5Q0CFw3rYrtCy2s,1065
+sarvam_cli_app-1.17.13.dist-info/RECORD,,

sarvam_cli_app-1.17.13.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

sarvam_cli_app-1.17.13.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+sarvam = sarvam_cli.cli:main
+sarvam-cli = sarvam_cli.cli:main

sarvam_cli_app-1.17.13.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.