sentinelmeet-v2 2.0.0__tar.gz

sentinelmeet_v2-2.0.0/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+dist/
+*.egg-info/
+__pycache__/

sentinelmeet_v2-2.0.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Apocys
+
+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.

sentinelmeet_v2-2.0.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.5
+Name: sentinelmeet-v2
+Version: 2.0.0
+Summary: Installer for SentinelMeet v2: private, on-device meeting transcription, live translation and speaker ID for macOS (Apple Silicon). `pip install sentinelmeet-v2 && sentinelmeet install`.
+Project-URL: Homepage, https://spawnkit.ai/#sentinelmeet
+Project-URL: Releases, https://spawnkit.ai/sentinelmeet/
+Author: Apocys
+License-Expression: MIT
+License-File: LICENSE
+Keywords: diarization,installer,meetings,sentinelos,transcription,translation,whisper
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# sentinelmeet-v2
+
+Installer for **SentinelMeet v2**, a private meeting assistant for macOS by [SpawnKit](https://spawnkit.ai/#sentinelmeet).
+Live transcription (Whisper large-v3-turbo), live translation, speaker identification and summaries, processed on your Mac.
+Cloud summaries and CRM publication are optional and off until you turn them on.
+
+```bash
+pip install sentinelmeet-v2
+sentinelmeet install --launch
+```
+
+The command downloads the latest build from `spawnkit.ai/sentinelmeet/`, checks its SHA-256,
+and installs `/Applications/SentinelMeet v2.app`. An existing SentinelMeet v1 install is left untouched.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `sentinelmeet install [--version v2.0.0] [-y] [--launch]` | Install (or update to) a release |
+| `sentinelmeet status` | Installed version, downloaded models, latest release |
+| `sentinelmeet open` | Launch the app |
+| `sentinelmeet uninstall [--purge]` | Remove the app; `--purge` also deletes meetings, models, settings |
+
+## Requirements
+
+- **macOS 13+ on Apple Silicon** (M1 or later). Windows is coming; Linux is not planned yet.
+- Python 3.9 or newer for this installer.
+- About 5 GB free for the speech and summary models, downloaded on first launch.
+- macOS asks for **Microphone** and **Screen Recording** (needed to hear the other side of a call).
+
+## Notes
+
+- This build is not notarized by Apple yet. The installer removes the download quarantine flag so macOS lets it open.
+- The app bundles FFmpeg 9.0.1 (static arm64 build from martin-riedl.de), licensed under the GPL v3. Source: https://ffmpeg.org/download.html
+
+Support: support@spawnkit.ai

sentinelmeet_v2-2.0.0/README.md

@@ -0,0 +1,36 @@
+# sentinelmeet-v2
+
+Installer for **SentinelMeet v2**, a private meeting assistant for macOS by [SpawnKit](https://spawnkit.ai/#sentinelmeet).
+Live transcription (Whisper large-v3-turbo), live translation, speaker identification and summaries, processed on your Mac.
+Cloud summaries and CRM publication are optional and off until you turn them on.
+
+```bash
+pip install sentinelmeet-v2
+sentinelmeet install --launch
+```
+
+The command downloads the latest build from `spawnkit.ai/sentinelmeet/`, checks its SHA-256,
+and installs `/Applications/SentinelMeet v2.app`. An existing SentinelMeet v1 install is left untouched.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `sentinelmeet install [--version v2.0.0] [-y] [--launch]` | Install (or update to) a release |
+| `sentinelmeet status` | Installed version, downloaded models, latest release |
+| `sentinelmeet open` | Launch the app |
+| `sentinelmeet uninstall [--purge]` | Remove the app; `--purge` also deletes meetings, models, settings |
+
+## Requirements
+
+- **macOS 13+ on Apple Silicon** (M1 or later). Windows is coming; Linux is not planned yet.
+- Python 3.9 or newer for this installer.
+- About 5 GB free for the speech and summary models, downloaded on first launch.
+- macOS asks for **Microphone** and **Screen Recording** (needed to hear the other side of a call).
+
+## Notes
+
+- This build is not notarized by Apple yet. The installer removes the download quarantine flag so macOS lets it open.
+- The app bundles FFmpeg 9.0.1 (static arm64 build from martin-riedl.de), licensed under the GPL v3. Source: https://ffmpeg.org/download.html
+
+Support: support@spawnkit.ai

sentinelmeet_v2-2.0.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sentinelmeet-v2"
+version = "2.0.0"
+description = "Installer for SentinelMeet v2: private, on-device meeting transcription, live translation and speaker ID for macOS (Apple Silicon). `pip install sentinelmeet-v2 && sentinelmeet install`."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "Apocys" }]
+keywords = ["meetings", "transcription", "whisper", "translation", "diarization", "installer", "sentinelos"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: MacOS X",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Topic :: Office/Business",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+]
+# stdlib only: urllib, json, subprocess, hashlib, pathlib, tempfile
+dependencies = []
+
+[project.urls]
+Homepage = "https://spawnkit.ai/#sentinelmeet"
+Releases = "https://spawnkit.ai/sentinelmeet/"
+
+[project.scripts]
+sentinelmeet = "sentinelmeet_installer.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sentinelmeet_installer"]

sentinelmeet_v2-2.0.0/src/sentinelmeet_installer/__init__.py

@@ -0,0 +1,2 @@
+"""SentinelMeet installer package."""
+__version__ = "2.0.0"

sentinelmeet_v2-2.0.0/src/sentinelmeet_installer/cli.py

@@ -0,0 +1,311 @@
+"""SentinelMeet installer CLI.
+
+    sentinelmeet install [--version vX.Y.Z] [--yes]
+    sentinelmeet uninstall
+    sentinelmeet status
+    sentinelmeet open
+
+Pure stdlib. Downloads the signed release asset from GitHub Releases, verifies
+its SHA-256 against the release's SHA256SUMS when present, and installs:
+  macOS   → /Applications/SentinelMeet.app (from the .dmg)
+  Windows → runs the NSIS setup.exe
+Linux is not supported by the app yet (system-audio capture is macOS/Windows).
+"""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import os
+import platform
+import shutil
+import subprocess
+import sys
+import tempfile
+import urllib.error
+import urllib.request
+from pathlib import Path
+
+REPO = os.environ.get("SENTINELMEET_REPO", "apocys/meeting-speech")
+API = f"https://api.github.com/repos/{REPO}/releases"
+# Public download feed (same shape as a GitHub release: tag_name + assets[]). Set SENTINELMEET_FEED="" to use GitHub.
+FEED = os.environ.get("SENTINELMEET_FEED", "https://spawnkit.ai/sentinelmeet/releases/latest.json")
+UA = {"User-Agent": "sentinelmeet-installer", "Accept": "application/vnd.github+json"}
+APP_NAME = "SentinelMeet v2"
+MAC_APP = Path("/Applications") / f"{APP_NAME}.app"
+MAC_DATA = Path.home() / "Library/Application Support/com.apocys.sentinelmeet-v2"
+
+
+class InstallError(RuntimeError):
+    pass
+
+
+# ----------------------------------------------------------------------------- github
+
+
+def _get_json(url: str) -> dict:
+    req = urllib.request.Request(url, headers=UA)
+    with urllib.request.urlopen(req, timeout=30) as r:
+        return json.loads(r.read().decode())
+
+
+def fetch_release(version: str | None) -> dict:
+    if FEED:
+        base = FEED.rsplit("/", 1)[0]
+        url = FEED if not version else f"{base}/{version if version.startswith('v') else 'v' + version}.json"
+        try:
+            return _get_json(url)
+        except urllib.error.HTTPError as e:
+            if e.code == 404:
+                raise InstallError(f"No release found ({'latest' if not version else version}) at {url}") from None
+            raise InstallError(f"Download feed error: {e}") from None
+    url = f"{API}/latest" if not version else f"{API}/tags/{version if version.startswith('v') else 'v' + version}"
+    try:
+        return _get_json(url)
+    except urllib.error.HTTPError as e:
+        if e.code == 404:
+            raise InstallError(
+                f"No release found ({'latest' if not version else version}) on github.com/{REPO}. "
+                "Check https://github.com/%s/releases" % REPO
+            ) from None
+        raise InstallError(f"GitHub API error: {e}") from None
+
+
+def pick_asset(release: dict, system: str, machine: str) -> dict:
+    """Choose the asset for this OS/arch. Names follow Tauri's bundler."""
+    assets = release.get("assets", [])
+    names = [a["name"] for a in assets]
+
+    def find(*needles: str) -> dict | None:
+        for a in assets:
+            n = a["name"].lower()
+            if all(x in n for x in needles):
+                return a
+        return None
+
+    if system == "Darwin":
+        if machine not in ("arm64", "aarch64"):
+            raise InstallError("SentinelMeet ships for Apple Silicon only (M1 and later).")
+        a = find("aarch64", ".dmg") or find("arm64", ".dmg")
+    elif system == "Windows":
+        a = find("x64", "setup", ".exe") or find("x64", ".msi")
+    else:
+        raise InstallError("Linux is not supported yet (system-audio capture is macOS/Windows only).")
+    if not a:
+        raise InstallError(f"No asset for {system}/{machine} in release {release.get('tag_name')}. Assets: {names}")
+    return a
+
+
+def fetch_sha256sums(release: dict) -> dict[str, str]:
+    for a in release.get("assets", []):
+        if a["name"].upper().startswith("SHA256SUMS"):
+            with urllib.request.urlopen(urllib.request.Request(a["browser_download_url"], headers=UA), timeout=30) as r:
+                out = {}
+                for line in r.read().decode().splitlines():
+                    parts = line.split()
+                    if len(parts) >= 2:
+                        out[parts[-1].lstrip("*")] = parts[0].lower()
+                return out
+    return {}
+
+
+# ----------------------------------------------------------------------------- download
+
+
+def download(url: str, dest: Path, expected_size: int | None = None) -> None:
+    req = urllib.request.Request(url, headers={"User-Agent": UA["User-Agent"]})
+    with urllib.request.urlopen(req, timeout=60) as r, open(dest, "wb") as f:
+        total = expected_size or int(r.headers.get("Content-Length") or 0)
+        done = 0
+        last = -1
+        while True:
+            chunk = r.read(1 << 20)
+            if not chunk:
+                break
+            f.write(chunk)
+            done += len(chunk)
+            if total:
+                pct = done * 100 // total
+                if pct != last and pct % 5 == 0:
+                    sys.stdout.write(f"\r  downloading {dest.name}  {pct:3d}%  ({done // (1 << 20)} / {total // (1 << 20)} MB)")
+                    sys.stdout.flush()
+                    last = pct
+    sys.stdout.write("\n")
+
+
+def sha256(path: Path) -> str:
+    h = hashlib.sha256()
+    with open(path, "rb") as f:
+        for chunk in iter(lambda: f.read(1 << 20), b""):
+            h.update(chunk)
+    return h.hexdigest()
+
+
+# ----------------------------------------------------------------------------- install
+
+
+def install_macos_dmg(dmg: Path, yes: bool) -> Path:
+    mnt = Path(tempfile.mkdtemp(prefix="sentinelmeet-dmg-"))
+    subprocess.run(["hdiutil", "attach", str(dmg), "-nobrowse", "-quiet", "-mountpoint", str(mnt)], check=True)
+    try:
+        apps = list(mnt.glob("*.app"))
+        if not apps:
+            raise InstallError("No .app inside the dmg")
+        src = apps[0]
+        # Keep the bundle's own name ("SentinelMeet v2.app") so v1 is never overwritten.
+        dest = Path("/Applications") / src.name
+        if dest.exists():
+            if not yes and not _confirm(f"{dest} exists. Replace it?"):
+                raise InstallError("Aborted.")
+            subprocess.run(["pkill", "-x", "sentinelmeet"], check=False)
+            shutil.rmtree(dest)
+        shutil.copytree(src, dest, symlinks=True)
+        # Unsigned/ad-hoc builds carry the quarantine bit → Gatekeeper refuses.
+        subprocess.run(["xattr", "-dr", "com.apple.quarantine", str(dest)], check=False)
+        return dest
+    finally:
+        subprocess.run(["hdiutil", "detach", str(mnt), "-quiet"], check=False)
+
+
+def install_windows(setup: Path, yes: bool) -> Path:
+    args = [str(setup)]
+    if yes:
+        args.append("/S")  # NSIS silent
+    subprocess.run(args, check=True)
+    return Path(os.environ.get("LOCALAPPDATA", "")) / APP_NAME
+
+
+def _confirm(q: str) -> bool:
+    return input(f"{q} [y/N] ").strip().lower() in ("y", "yes")
+
+
+# ----------------------------------------------------------------------------- commands
+
+
+def cmd_install(args: argparse.Namespace) -> int:
+    system, machine = platform.system(), platform.machine()
+    print(f"SentinelMeet installer — {system} {machine}")
+    rel = fetch_release(args.version)
+    asset = pick_asset(rel, system, machine)
+    tag = rel.get("tag_name")
+    print(f"  release {tag}: {asset['name']} ({asset['size'] // (1 << 20)} MB)")
+    sums = fetch_sha256sums(rel)
+
+    with tempfile.TemporaryDirectory(prefix="sentinelmeet-") as td:
+        path = Path(td) / asset["name"]
+        download(asset["browser_download_url"], path, asset.get("size"))
+        digest = sha256(path)
+        if asset["name"] in sums:
+            if sums[asset["name"]] != digest:
+                raise InstallError("SHA-256 mismatch — download corrupted or tampered. Aborting.")
+            print("  sha256 verified ✓")
+        else:
+            print(f"  sha256 {digest[:16]}… (no SHA256SUMS in this release — not verified)")
+
+        if system == "Darwin":
+            dest = install_macos_dmg(path, args.yes)
+        else:
+            dest = install_windows(path, args.yes)
+
+    print(f"\n✅ Installed {APP_NAME} {tag} → {dest}")
+    print("First launch downloads the speech models (~1.6 GB Whisper turbo + ~2.7 GB Qwen) — one time.")
+    if system == "Darwin":
+        print("macOS will ask for Microphone and Screen Recording (system audio) permissions.")
+        if args.launch:
+            subprocess.run(["open", str(dest)], check=False)
+        else:
+            print("Run:  sentinelmeet open")
+    return 0
+
+
+def cmd_uninstall(args: argparse.Namespace) -> int:
+    if platform.system() != "Darwin":
+        print("On Windows use Settings › Apps › SentinelMeet › Uninstall.")
+        return 1
+    if not MAC_APP.exists():
+        print("Not installed.")
+        return 0
+    if not args.yes and not _confirm(f"Remove {MAC_APP}?"):
+        return 1
+    subprocess.run(["pkill", "-x", "sentinelmeet"], check=False)
+    shutil.rmtree(MAC_APP)
+    print("Removed app.")
+    if args.purge:
+        if MAC_DATA.exists() and (args.yes or _confirm(f"Also delete meetings, models and settings in {MAC_DATA}?")):
+            shutil.rmtree(MAC_DATA)
+            print("Removed data.")
+    else:
+        print(f"Meetings/models kept in {MAC_DATA} (use --purge to delete).")
+    return 0
+
+
+def cmd_status(_: argparse.Namespace) -> int:
+    system = platform.system()
+    if system == "Darwin":
+        installed = MAC_APP.exists()
+        ver = None
+        if installed:
+            try:
+                out = subprocess.run(
+                    ["defaults", "read", str(MAC_APP / "Contents/Info.plist"), "CFBundleShortVersionString"],
+                    capture_output=True, text=True, check=True,
+                ).stdout.strip()
+                ver = out
+            except Exception:
+                pass
+        print(f"app:      {'installed ' + (ver or '') if installed else 'not installed'}  ({MAC_APP})")
+        models = MAC_DATA / "models"
+        if models.exists():
+            names = sorted(p.name for p in models.rglob("*") if p.is_file() and p.suffix in (".bin", ".gguf"))
+            print(f"models:   {', '.join(names) if names else 'none yet'}")
+        db = MAC_DATA / "meeting_minutes.sqlite"
+        print(f"database: {'present' if db.exists() else 'none'}  ({db})")
+    else:
+        print(f"{system}: use the app's Settings for status.")
+    try:
+        latest = fetch_release(None).get("tag_name")
+        print(f"latest:   {latest}")
+    except InstallError as e:
+        print(f"latest:   ? ({e})")
+    return 0
+
+
+def cmd_open(_: argparse.Namespace) -> int:
+    if platform.system() == "Darwin" and MAC_APP.exists():
+        subprocess.run(["open", str(MAC_APP)], check=False)
+        return 0
+    print("App not installed. Run: sentinelmeet install")
+    return 1
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(prog="sentinelmeet", description="Install / manage the SentinelMeet desktop app.")
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    i = sub.add_parser("install", help="download and install the latest release")
+    i.add_argument("--version", help="specific tag, e.g. v0.5.0 (default: latest)")
+    i.add_argument("--yes", "-y", action="store_true", help="no prompts; replace existing install")
+    i.add_argument("--launch", action="store_true", help="open the app after installing")
+    i.set_defaults(fn=cmd_install)
+
+    u = sub.add_parser("uninstall", help="remove the app (keeps your data unless --purge)")
+    u.add_argument("--yes", "-y", action="store_true")
+    u.add_argument("--purge", action="store_true", help="also delete meetings, models and settings")
+    u.set_defaults(fn=cmd_uninstall)
+
+    sub.add_parser("status", help="installed version, models, latest release").set_defaults(fn=cmd_status)
+    sub.add_parser("open", help="launch the app").set_defaults(fn=cmd_open)
+
+    args = p.parse_args(argv)
+    try:
+        return args.fn(args)
+    except InstallError as e:
+        print(f"✗ {e}", file=sys.stderr)
+        return 2
+    except KeyboardInterrupt:
+        print("\naborted", file=sys.stderr)
+        return 130
+
+
+if __name__ == "__main__":
+    sys.exit(main())

sentinelmeet_v2-2.0.0/tests/test_cli.py

@@ -0,0 +1,35 @@
+import json
+from sentinelmeet_installer import cli
+
+
+def rel(names):
+    return {"tag_name": "v0.5.0", "assets": [{"name": n, "size": 1, "browser_download_url": "x"} for n in names]}
+
+
+def test_pick_macos_arm():
+    r = rel(["SentinelMeet_0.5.0_aarch64.dmg", "SentinelMeet_0.5.0_x64-setup.exe", "SHA256SUMS"])
+    assert cli.pick_asset(r, "Darwin", "arm64")["name"].endswith("aarch64.dmg")
+
+
+def test_pick_windows():
+    r = rel(["SentinelMeet_0.5.0_aarch64.dmg", "SentinelMeet_0.5.0_x64-setup.exe"])
+    assert cli.pick_asset(r, "Windows", "AMD64")["name"].endswith("setup.exe")
+
+
+def test_intel_mac_refused():
+    import pytest
+    with pytest.raises(cli.InstallError):
+        cli.pick_asset(rel(["SentinelMeet_0.5.0_aarch64.dmg"]), "Darwin", "x86_64")
+
+
+def test_linux_refused():
+    import pytest
+    with pytest.raises(cli.InstallError):
+        cli.pick_asset(rel(["a.dmg"]), "Linux", "x86_64")
+
+
+def test_cli_help_runs():
+    import pytest
+    with pytest.raises(SystemExit) as e:
+        cli.main(["--help"])
+    assert e.value.code == 0