aioli-cli 0.1.2__tar.gz

aioli_cli-0.1.2/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+.venv/
+
+# web
+web/node_modules/
+web/dist/
+web/.astro/
+
+dist/

aioli_cli-0.1.2/LICENSE

@@ -0,0 +1,39 @@
+MIT License
+
+Copyright (c) 2026 aioli contributors
+
+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.
+
+---
+
+## Third-party notes (not covered by the MIT above)
+
+aioli downloads WEIGHTS, it does not ship them. Each weight file keeps its
+own license, shown before download (`GATED_NOTE` in every `models_data.py`):
+
+- Flux / LTX-2.5 weights: gated HuggingFace repos — accept the upstream
+  license on the web before downloading.
+- Piper voices: no additional license imposed upstream (end-user judgement).
+- Chatterbox / XTTS engines: check upstream terms (non-commercial clauses
+  may apply) before monetized use.
+
+External tools aioli talks to (never bundled) keep their licenses:
+Wan2GP, ComfyUI (GPL-3.0), acestep.cpp, Blender. The `aioli™` name and the
+logo/mascot in `assets/` are not covered by the MIT grant — ask before
+selling anything called "aioli".

aioli_cli-0.1.2/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.5
+Name: aioli-cli
+Version: 0.1.2
+Summary: aioli — local-first AI media suite CLI (images, video, music, voice, podcast)
+Author: aioli contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai,generative,image,local-first,music,tts,video
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: huggingface-hub>=0.30
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: kokoro-onnx>=0.4
+Requires-Dist: numpy>=1.26
+Requires-Dist: pydantic-settings>=2.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: soundfile>=0.12
+Requires-Dist: typer>=0.12
+Provides-Extra: music-storage
+Requires-Dist: boto3>=1.34; extra == 'music-storage'
+Provides-Extra: voice-piper
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo-transparent.png" width="220" alt="aioli logo — robot garlic" />
+</p>
+
+<h1 align="center">🧄 aioli</h1>
+
+<p align="center">
+  <em>Local-first AI media suite. One CLI, many plugins — everything on your machine, no cloud required. 🌙</em>
+</p>
+
+<p align="center">
+  🎙️ Voice &nbsp;•&nbsp; 🎵 Music &nbsp;•&nbsp; 🖼️ Image &nbsp;•&nbsp; 🎬 Video &nbsp;•&nbsp; 🎧 Post &nbsp;•&nbsp; 🎙️📻 Podcast
+</p>
+
+---
+
+## ✨ Quickstart
+
+```bash
+curl -LsSf aioli.es/install.sh | sh   # 🧄 dummy-proof: equipo → consejo → modelos
+# …o paso a paso:
+uv tool install aioli-cli            # 📦 un paquete; extras: aioli-cli[voice-qwen3,full]
+aioli setup                            # 🧭 asesora según tu GPU y descarga pesos
+aioli doctor                           # 🩺 preflight: CUDA, ffmpeg, models, VRAM
+aioli models download image music      # ⬇️ weights with resume + sha256 (HF_TOKEN for gated repos)
+aioli voice generate "..." --profile vega   # 🎙️ clone a voice
+aioli music generate "rumba alegre" --backend yue2  # 🎵 compose a song
+aioli podcast episode "la historia del café" --minutes 5  # 📻 full episode
+```
+
+> **Desde el repo (dev):** `uv tool install -e .` desde la raíz (un solo
+> paquete editable con todo dentro). Extras: `uv tool install -e ".[full]"`.
+
+## 🗂️ Layout
+
+```
+aioli/
+  apps/aioli/src/aioli_cli/  # 🧄 CLI (Typer + registry + setup + models)
+  libs/contract/src/         # 📜 contrato: config, doctor, probe, advise, fetch
+  plugins/*/src/             # 🔌 un módulo por modalidad (mismo dist, entry points para terceros)
+  docs/catalog.md    # 🗺️ inventory of everything (legacy + new)
+  assets/            # 🎨 logo + mascot variants
+```
+
+## 📚 Docs
+
+| Doc | Para quién |
+|---|---|
+| [docs/INSTALL.md](docs/INSTALL.md) | 🧑‍💻 instalar desde cero (requisitos, HF_TOKEN, problemas comunes) |
+| [docs/USAGE.md](docs/USAGE.md) | 🎨 recetas validadas por plugin (comandos que funcionan) |
+| [docs/adr/](docs/adr/) | 🧠 por qué se decidió cada cosa (4 ADRs) |
+| [docs/catalog.md](docs/catalog.md) | 🗺️ inventario vivo: portado vs legacy + deuda |
+
+## 📜 Contract (every plugin obeys it)
+
+- ▶️ `aioli <plugin> generate ...` — produce media
+- ⬇️ `aioli <plugin> models download` — fetch weights with checksum
+- 🩺 `aioli doctor` — preflight: CUDA, ffmpeg, models, VRAM
+- ⚙️ Config in `~/.config/aioli/config.toml`, env overrides (`AIOLI_MODELS_DIR`, …)
+- 🚫 No absolute paths, no hardcoded GPUs, no cloud credentials required.
+
+## 🗺️ Status
+
+See [docs/catalog.md](docs/catalog.md) for the living inventory: what's ported, what's legacy, and the tech debt. 🧾

aioli_cli-0.1.2/README.md

@@ -0,0 +1,64 @@
+<p align="center">
+  <img src="assets/logo-transparent.png" width="220" alt="aioli logo — robot garlic" />
+</p>
+
+<h1 align="center">🧄 aioli</h1>
+
+<p align="center">
+  <em>Local-first AI media suite. One CLI, many plugins — everything on your machine, no cloud required. 🌙</em>
+</p>
+
+<p align="center">
+  🎙️ Voice &nbsp;•&nbsp; 🎵 Music &nbsp;•&nbsp; 🖼️ Image &nbsp;•&nbsp; 🎬 Video &nbsp;•&nbsp; 🎧 Post &nbsp;•&nbsp; 🎙️📻 Podcast
+</p>
+
+---
+
+## ✨ Quickstart
+
+```bash
+curl -LsSf aioli.es/install.sh | sh   # 🧄 dummy-proof: equipo → consejo → modelos
+# …o paso a paso:
+uv tool install aioli-cli            # 📦 un paquete; extras: aioli-cli[voice-qwen3,full]
+aioli setup                            # 🧭 asesora según tu GPU y descarga pesos
+aioli doctor                           # 🩺 preflight: CUDA, ffmpeg, models, VRAM
+aioli models download image music      # ⬇️ weights with resume + sha256 (HF_TOKEN for gated repos)
+aioli voice generate "..." --profile vega   # 🎙️ clone a voice
+aioli music generate "rumba alegre" --backend yue2  # 🎵 compose a song
+aioli podcast episode "la historia del café" --minutes 5  # 📻 full episode
+```
+
+> **Desde el repo (dev):** `uv tool install -e .` desde la raíz (un solo
+> paquete editable con todo dentro). Extras: `uv tool install -e ".[full]"`.
+
+## 🗂️ Layout
+
+```
+aioli/
+  apps/aioli/src/aioli_cli/  # 🧄 CLI (Typer + registry + setup + models)
+  libs/contract/src/         # 📜 contrato: config, doctor, probe, advise, fetch
+  plugins/*/src/             # 🔌 un módulo por modalidad (mismo dist, entry points para terceros)
+  docs/catalog.md    # 🗺️ inventory of everything (legacy + new)
+  assets/            # 🎨 logo + mascot variants
+```
+
+## 📚 Docs
+
+| Doc | Para quién |
+|---|---|
+| [docs/INSTALL.md](docs/INSTALL.md) | 🧑‍💻 instalar desde cero (requisitos, HF_TOKEN, problemas comunes) |
+| [docs/USAGE.md](docs/USAGE.md) | 🎨 recetas validadas por plugin (comandos que funcionan) |
+| [docs/adr/](docs/adr/) | 🧠 por qué se decidió cada cosa (4 ADRs) |
+| [docs/catalog.md](docs/catalog.md) | 🗺️ inventario vivo: portado vs legacy + deuda |
+
+## 📜 Contract (every plugin obeys it)
+
+- ▶️ `aioli <plugin> generate ...` — produce media
+- ⬇️ `aioli <plugin> models download` — fetch weights with checksum
+- 🩺 `aioli doctor` — preflight: CUDA, ffmpeg, models, VRAM
+- ⚙️ Config in `~/.config/aioli/config.toml`, env overrides (`AIOLI_MODELS_DIR`, …)
+- 🚫 No absolute paths, no hardcoded GPUs, no cloud credentials required.
+
+## 🗺️ Status
+
+See [docs/catalog.md](docs/catalog.md) for the living inventory: what's ported, what's legacy, and the tech debt. 🧾

aioli_cli-0.1.2/pyproject.toml

@@ -0,0 +1,114 @@
+[project]
+name = "aioli-cli"
+version = "0.1.2"
+description = "aioli — local-first AI media suite CLI (images, video, music, voice, podcast)"
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [{ name = "aioli contributors" }]
+keywords = ["ai", "generative", "local-first", "tts", "image", "video", "music"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Operating System :: POSIX :: Linux",
+    "Topic :: Multimedia",
+]
+dependencies = [
+    # base: CLI + contrato + todos los plugins (el codigo pesa KB; los pesos
+    # se descargan con `aioli setup`). Motores pesados van en extras.
+    "typer>=0.12",
+    "rich>=13.0",
+    "InquirerPy>=0.3.4",
+    "httpx>=0.27",
+    "huggingface-hub>=0.30",
+    "pydantic>=2.7",
+    "pydantic-settings>=2.3",
+    "pyyaml>=6.0",
+    "numpy>=1.26",
+    "soundfile>=0.12",
+    "kokoro-onnx>=0.4",
+]
+
+
+[project.optional-dependencies]
+# Solo extras COMPATIBLES entre si: el lock del workspace los resuelve todos
+# juntos. Los motores torch (qwen3/chatterbox/voxcpm/xtts/moss) se instalan a
+# mano — ver plugins/voice/README.md (son mundos de dependencias incompatibles
+# entre si: moss clava transformers==4.57.1, qwen-tts exige ==4.57.3).
+voice-piper = []  # binario externo (`uv tool install piper-tts`), sin deps python
+music-storage = ["boto3>=1.34"]
+
+[project.scripts]
+aioli = "aioli_cli.main:main"
+
+# Third-party plugins: register a `Plugin` (or zero-arg callable returning
+# one, see aioli_cli.registry.Plugin) under this group in YOUR package:
+#   [project.entry-points."aioli.plugins"]
+#   comic = "aioli_comic.plugin:comic_plugin"
+[project.entry-points."aioli.plugins"]
+# (builtin plugins load directly from this same dist; the group is for externals)
+
+[tool.uv.workspace]
+members = ["libs/*", "plugins/*"]
+
+[tool.uv]
+override-dependencies = [
+    "torch>=2.7,<3",
+    "torchaudio>=2.7,<3",
+]
+
+[[tool.uv.index]]
+name = "pytorch-cu128"
+url = "https://download.pytorch.org/whl/cu128"
+explicit = true
+
+[tool.uv.sources]
+torch = { index = "pytorch-cu128" }
+torchaudio = { index = "pytorch-cu128" }
+torchcodec = { index = "pytorch-cu128" }
+moss-tts-nano = { git = "https://github.com/OpenMOSS/MOSS-TTS-Nano", rev = "cc7bdf19c7639c0870dab22045a33b442760f6be" }
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+# Single dist: todo el codigo (CLI + contrato + plugins) en un wheel.
+[tool.hatch.build.targets.wheel]
+packages = [
+    "src/aioli_cli",
+    "src/aioli_contract",
+    "src/aioli_voice",
+    "src/aioli_image",
+    "src/aioli_video",
+    "src/aioli_music",
+    "src/aioli_podcast",
+    "src/aioli_master",
+]
+
+[tool.hatch.build.targets.sdist]
+# only-include PRESERVA rutas (packages las aplana y rompe el wheel-from-sdist).
+only-include = [
+    "src",
+    "pyproject.toml",
+    "README.md",
+    "LICENSE",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = [
+    "libs/contract/tests",
+    "plugins/voice/tests",
+    "plugins/image/tests",
+    "plugins/video/tests",
+    "plugins/music/tests",
+    "plugins/podcast/tests",
+    "plugins/master/tests",
+]
+addopts = "-q"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pillow>=10.0",  # solo tests (stubs de imagen); nunca en dependencies
+]

aioli_cli-0.1.2/src/aioli_cli/_plugins.py

@@ -0,0 +1,148 @@
+"""Lazy plugin loader: import each installed plugin package and register it.
+
+Plugins are optional — a missing package is silently skipped so the `aioli`
+binary keeps working with whatever is installed.
+"""
+
+from aioli_cli.registry import Plugin, registry
+
+
+_LOADED = False
+
+ENTRY_POINT_GROUP = "aioli.plugins"
+
+
+def _load_entry_points() -> None:
+    """Third-party plugins via `[project.entry-points."aioli.plugins"]`.
+
+    Each entry point must resolve to a `registry.Plugin` instance or to a
+    zero-arg callable returning one (so externals never touch our release).
+    """
+    try:
+        from importlib.metadata import entry_points
+    except ImportError:  # pragma: no cover — py3.12 always has it
+        return
+    try:
+        eps = entry_points(group=ENTRY_POINT_GROUP)
+    except Exception:
+        return
+    for ep in eps:
+        if ep.name in registry._plugins:
+            continue
+        try:
+            obj = ep.load()
+            plugin = obj() if callable(obj) and not isinstance(obj, Plugin) else obj
+            if isinstance(plugin, Plugin):
+                registry.register(plugin)
+        except Exception:
+            continue
+
+
+def load_all() -> None:
+    """Import plugin packages and register their Typer apps + checks."""
+    global _LOADED
+    if _LOADED:
+        return
+    _LOADED = True
+    try:
+        from aioli_voice.models_data import DEFAULT_BACKEND as VOICE_DEFAULT
+        from aioli_voice.models_data import MODELS as VOICE_MODELS
+        from aioli_voice.plugin import DESCRIPTION, voice_app, voice_checks
+
+        registry.register(
+            Plugin(
+                name="voice",
+                description=DESCRIPTION,
+                app=voice_app,
+                checks=voice_checks,
+                models=lambda: VOICE_MODELS,
+                default_backend=VOICE_DEFAULT,
+            )
+        )
+    except ImportError:
+        pass
+    try:
+        from aioli_image.models_data import GATED_NOTE as IMAGE_GATED
+        from aioli_image.models_data import DEFAULT_BACKEND as IMAGE_DEFAULT
+        from aioli_image.models_data import MODELS as IMAGE_MODELS
+        from aioli_image.plugin import DESCRIPTION, image_app, image_checks
+
+        registry.register(
+            Plugin(
+                name="image",
+                description=DESCRIPTION,
+                app=image_app,
+                checks=image_checks,
+                models=lambda: IMAGE_MODELS,
+                default_backend=IMAGE_DEFAULT,
+                gated_note=IMAGE_GATED,
+            )
+        )
+    except ImportError:
+        pass
+    try:
+        from aioli_video.models_data import GATED_NOTE as VIDEO_GATED
+        from aioli_video.models_data import DEFAULT_BACKEND as VIDEO_DEFAULT
+        from aioli_video.models_data import MODELS as VIDEO_MODELS
+        from aioli_video.plugin import DESCRIPTION, video_app, video_checks
+
+        registry.register(
+            Plugin(
+                name="video",
+                description=DESCRIPTION,
+                app=video_app,
+                checks=video_checks,
+                models=lambda: VIDEO_MODELS,
+                default_backend=VIDEO_DEFAULT,
+                gated_note=VIDEO_GATED,
+            )
+        )
+    except ImportError:
+        pass
+    try:
+        from aioli_podcast.plugin import DESCRIPTION, podcast_app, podcast_checks
+
+        registry.register(
+            Plugin(
+                name="podcast",
+                description=DESCRIPTION,
+                app=podcast_app,
+                checks=podcast_checks,
+            )
+        )
+    except ImportError:
+        pass
+    try:
+        from aioli_master.plugin import DESCRIPTION, master_app, master_checks
+
+        registry.register(
+            Plugin(
+                name="master",
+                description=DESCRIPTION,
+                app=master_app,
+                checks=master_checks,
+            )
+        )
+    except ImportError:
+        pass
+    try:
+        from aioli_music.models_data import GATED_NOTE as MUSIC_GATED
+        from aioli_music.models_data import DEFAULT_BACKEND as MUSIC_DEFAULT
+        from aioli_music.models_data import MODELS as MUSIC_MODELS
+        from aioli_music.plugin import DESCRIPTION, music_app, music_checks
+
+        registry.register(
+            Plugin(
+                name="music",
+                description=DESCRIPTION,
+                app=music_app,
+                checks=music_checks,
+                models=lambda: MUSIC_MODELS,
+                default_backend=MUSIC_DEFAULT,
+                gated_note=MUSIC_GATED,
+            )
+        )
+    except ImportError:
+        pass
+
+    _load_entry_points()

aioli_cli-0.1.2/src/aioli_cli/main.py

@@ -0,0 +1,215 @@
+"""aioli CLI entry point."""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from aioli_cli.registry import registry
+from aioli_contract import AioliConfig, run_checks
+
+app = typer.Typer(
+    name="aioli",
+    help="🧄 aioli — local-first AI media suite.",
+    rich_markup_mode="rich",
+)
+console = Console()
+
+
+@app.command()
+def doctor() -> None:
+    """Preflight: python, ffmpeg, CUDA. Plugins append their own checks."""
+    cfg = AioliConfig.load()
+    table = Table(title="aioli doctor")
+    table.add_column("check")
+    table.add_column("status")
+    table.add_column("detail")
+    for check in run_checks():
+        table.add_row(check.name, "✅" if check.ok else "❌", check.hint)
+    for plugin in registry.all():
+        if plugin.checks is None:
+            continue
+        for check in plugin.checks():
+            table.add_row(
+                f"{plugin.name}/{check.name}",
+                "✅" if check.ok else "❌",
+                check.hint,
+            )
+    table.add_row("models_dir", "📁", str(cfg.models_dir))
+    table.add_row("plugins", "🔌", ", ".join(registry.names()) or "(none yet)")
+    console.print(table)
+
+
+@app.command()
+def setup(
+    yes: bool = typer.Option(False, "--yes", "-y", help="Sin preguntas: instala todo lo que quepa."),
+    plugins: str | None = typer.Option(None, "--plugins", "-p", help="Solo estos plugins (coma): image,video,music,voice."),
+) -> None:
+    """Asistente de primera instalación: equipo → consejo → descarga."""
+    from aioli_cli.setup import run_setup
+
+    run_setup(yes=yes, plugins=plugins)
+
+
+@app.command()
+def version() -> None:
+    """Show version."""
+    console.print("aioli 0.1.0")
+
+
+models_app = typer.Typer(help="Download + verify weight files.")
+app.add_typer(models_app, name="models")
+
+
+def _wanted(plugin: str | None, backend: str | None = None) -> list[tuple[str, dict]]:
+    from aioli_cli import _plugins  # noqa: PLC0415 — ensure loaded
+
+    _plugins.load_all()
+    out: list[tuple[str, dict]] = []
+    for p in registry.all():
+        if p.models is None:
+            continue
+        if plugin is not None and p.name != plugin:
+            continue
+        want = backend or p.default_backend or None
+        for entry in p.models():
+            if want is not None and want != "all" and entry.get("backend", "") != want:
+                continue
+            out.append((p.name, entry))
+    if plugin is not None and not out:
+        raise typer.BadParameter(f"no model manifest for plugin '{plugin}'")
+    return out
+
+
+def _backends() -> dict[str, list[str]]:
+    from aioli_cli import _plugins  # noqa: PLC0415 — ensure loaded
+
+    _plugins.load_all()
+    out: dict[str, list[str]] = {}
+    for p in registry.all():
+        if p.models is None:
+            continue
+        seen = sorted({e.get("backend", "?") for e in p.models()})
+        out[p.name] = seen
+    return out
+
+
+@models_app.command("list")
+def models_list(
+    plugin: str | None = typer.Argument(None),
+    backend: str | None = typer.Option(None, "--backend", "-b", help="Engine filter (default: plugin default; 'all' = every engine)."),
+) -> None:
+    """Show manifest entries + local status."""
+    from aioli_contract import ModelFile, default_models_dir, human_gb, verify
+
+    models_dir = default_models_dir()
+    table = Table(title=f"aioli models → {models_dir}")
+    table.add_column("plugin")
+    table.add_column("engine")
+    table.add_column("file")
+    table.add_column("size")
+    table.add_column("status")
+    for pname, raw in _wanted(plugin, backend):
+        entry = ModelFile(**raw)
+        status = verify(entry, models_dir)
+        icon = {"ok": "✅", "missing": "⬇️", "corrupt": "⚠️", "unverified": "❔"}[status]
+        table.add_row(pname, entry.backend or "-", entry.rel, human_gb(entry.size), f"{icon} {status}")
+    console.print(table)
+    if plugin is None and backend in (None, "all"):
+        for pname, engines in _backends().items():
+            console.print(f"   {pname} engines: {', '.join(engines)}")
+
+
+@models_app.command("download")
+def models_download(
+    plugin: str | None = typer.Argument(None),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
+    backend: str | None = typer.Option(None, "--backend", "-b", help="Engine only (default: plugin default; 'all' = every engine)."),
+    with_optional: bool = typer.Option(False, "--with-optional", help="Include optional files (ASR, alt quants)."),
+) -> None:
+    """Download weights with resume + sha256 verification."""
+    from aioli_contract import (
+        ModelFile,
+        check_space,
+        default_models_dir,
+        download,
+        human_gb,
+        verify,
+    )
+    from rich.progress import Progress
+
+    models_dir = default_models_dir()
+    wanted = [(pn, ModelFile(**raw)) for pn, raw in _wanted(plugin, backend)]
+    if not with_optional:
+        skipped = [e.rel for _, e in wanted if e.optional]
+        wanted = [(pn, e) for pn, e in wanted if not e.optional]
+        for rel in skipped:
+            console.print(f"⏭️  optional skipped: {rel} (use --with-optional)")
+    missing = [(pn, e) for pn, e in wanted if verify(e, models_dir) != "ok"]
+    if not missing:
+        console.print("✅ all models present + verified")
+        return
+    total = sum(e.size for _, e in missing)
+    fits, _needed, free = check_space([e for _, e in missing], models_dir)
+    console.print(f"⬇️  {len(missing)} file(s), {human_gb(total)} → {models_dir}")
+    if free:
+        console.print(f"   disk free: {human_gb(free)}")
+    if not fits:
+        raise typer.Abort(f"❌ not enough disk space for {human_gb(total)}")
+    notes = {registry._plugins[pn].gated_note for pn, _ in missing}
+    for note in sorted(n for n in notes if n):
+        console.print(f"🔑 {note}")
+    if not yes and not typer.confirm("Download now?"):
+        raise typer.Abort()
+
+    class _Bar:
+        def __init__(self, progress: Progress) -> None:
+            self.progress = progress
+            self.tasks: dict[str, int] = {}
+
+        def update(self, path, done_bytes: int, total_bytes: int) -> None:
+            key = str(path)
+            task = self.tasks.get(key)
+            if task is None:
+                task = self.progress.add_task(path.name, total=total_bytes or 1)
+                self.tasks[key] = task
+            self.progress.update(task, completed=done_bytes, total=total_bytes or 1)
+
+    with Progress() as progress:
+        bar = _Bar(progress)
+        for _pn, entry in missing:
+            try:
+                download(entry, models_dir, progress=bar)
+            except (IOError, ValueError) as exc:
+                console.print(f"❌ {entry.rel}: {exc}")
+                raise typer.Abort() from exc
+    console.print("✅ all models present + verified")
+
+
+@models_app.command("verify")
+def models_verify(plugin: str | None = typer.Argument(None)) -> None:
+    """Re-hash local files against the manifest."""
+    from aioli_contract import ModelFile, default_models_dir, verify
+
+    models_dir = default_models_dir()
+    bad = 0
+    for pname, raw in _wanted(plugin):
+        entry = ModelFile(**raw)
+        status = verify(entry, models_dir)
+        icon = {"ok": "✅", "missing": "⬇️", "corrupt": "⚠️", "unverified": "❔"}[status]
+        console.print(f"{icon} [{pname}] {entry.rel}: {status}")
+        if status == "corrupt":
+            bad += 1
+    if bad:
+        raise typer.Exit(code=1)
+
+
+def main() -> None:
+    from aioli_cli import _plugins
+
+    _plugins.load_all()
+    registry.attach(app)
+    app()
+
+
+if __name__ == "__main__":
+    main()