Agent Zero AI framework
plugins: thumbnails in plugin list and hub
Alessandro6aaa435a1d76
diff --git a/helpers/plugins.py b/helpers/plugins.pyindex 999805305..69c950634 100644--- a/helpers/plugins.py+++ b/helpers/plugins.py@@ -99,6 +99,7 @@ class PluginListItem(BaseModel):toggle_state: ToggleState = "disabled"current_commit: str = ""current_commit_timestamp: str = ""+ thumbnail_url: str = ""class PluginUpdateInfo(BaseModel):@@ -226,6 +227,13 @@ def get_enhanced_plugins_list(has_license = files.exists(str(d / "LICENSE"))has_execute_script = files.exists(str(d / "execute.py"))toggle_state = get_toggle_state(d.name)+ thumbnail_url = ""+ _thumb_exts = ("png", "jpg", "jpeg", "gif", "webp")+ for _ext in _thumb_exts:+ _thumb = d / "webui" / f"thumbnail.{_ext}"+ if _thumb.is_file():+ thumbnail_url = f"/plugins/{d.name}/webui/thumbnail.{_ext}"+ breakcurrent_commit = ""current_commit_timestamp = ""if is_custom:@@ -253,6 +261,7 @@ def get_enhanced_plugins_list(toggle_state=toggle_state,current_commit=current_commit,current_commit_timestamp=current_commit_timestamp,+ thumbnail_url=thumbnail_url,))except Exception as e:diff --git a/plugins/_plugin_installer/api/plugin_install.py b/plugins/_plugin_installer/api/plugin_install.pyindex df179b2e8..80f08a13d 100644--- a/plugins/_plugin_installer/api/plugin_install.py+++ b/plugins/_plugin_installer/api/plugin_install.py@@ -46,10 +46,11 @@ class PluginInstall(ApiHandler):git_url = (input.get("git_url", "") or "").strip()git_token = (input.get("git_token", "") or "").strip() or Noneplugin_name = input.get("plugin_name", "")+ thumbnail_url = (input.get("thumbnail_url") or "").strip()if not git_url:return {"success": False, "error": "Git URL is required"}- return install_from_git(url=git_url, token=git_token, plugin_name=plugin_name)+ return install_from_git(url=git_url, token=git_token, plugin_name=plugin_name, thumbnail_url=thumbnail_url)def _update_git(self, input: dict) -> dict:return update_from_git(input.get("plugin_name", ""))diff --git a/plugins/_plugin_installer/helpers/install.py b/plugins/_plugin_installer/helpers/install.pyindex 8b7e52782..d4e14ff0a 100644--- a/plugins/_plugin_installer/helpers/install.py+++ b/plugins/_plugin_installer/helpers/install.py@@ -151,7 +151,31 @@ def install_from_zip(zip_path: str, original_filename: str | None = None) -> dicpass-def install_from_git(url: str, token: str | None = None, plugin_name: str = "") -> dict:+def _download_thumbnail(thumbnail_url: str, plugin_dir: str) -> None:+ """Download thumbnail from URL to plugin_dir/webui/thumbnail.<ext>. Non-fatal."""+ try:+ if not thumbnail_url:+ return+ from urllib.parse import urlparse+ parsed = urlparse(thumbnail_url)+ if parsed.scheme not in ("http", "https"):+ return+ _allowed_exts = {"png", "jpg", "jpeg", "gif", "webp"}+ url_path = parsed.path.lower()+ ext = url_path.rsplit(".", 1)[-1] if "." in url_path else ""+ if ext not in _allowed_exts:+ ext = "png"+ webui_dir = Path(plugin_dir) / "webui"+ webui_dir.mkdir(parents=True, exist_ok=True)+ dest = webui_dir / f"thumbnail.{ext}"+ req = urllib.request.Request(thumbnail_url, headers={"User-Agent": "AgentZero"})+ with urllib.request.urlopen(req, timeout=10) as resp:+ dest.write_bytes(resp.read())+ except Exception as e:+ print_style.PrintStyle.warning(f"Failed to download plugin thumbnail: {e}")+++def install_from_git(url: str, token: str | None = None, plugin_name: str = "", thumbnail_url: str = "") -> dict:"""Clone git repo into usr/plugins/, validate plugin.yaml.Returns dict with plugin name and metadata."""from helpers.git import clone_repo@@ -173,6 +197,8 @@ def install_from_git(url: str, token: str | None = None, plugin_name: str = "")files.delete_dir(git_dir)raise+ _download_thumbnail(thumbnail_url, final_dir)+# run installation hooktry:run_install_hook(plugin_name)@@ -253,13 +279,45 @@ def get_plugin_hub_index() -> dict[str, Any]:if not isinstance(plugins, dict):raise ValueError("Plugin index payload is missing a valid 'plugins' map")+ from helpers.plugins import find_plugin_dir+installed_dirs = set(get_plugins_list())installed_keys: list[str] = []+ _thumb_exts = ("png", "jpg", "jpeg", "gif", "webp")+for key, plugin_data in plugins.items():if not isinstance(plugin_data, dict):continue- if key in installed_dirs:- installed_keys.append(key)+ if key not in installed_dirs:+ continue+ installed_keys.append(key)++ # Backfill thumbnail for plugins installed before this feature existed+ plugin_dir = find_plugin_dir(key)+ if not plugin_dir:+ continue+ webui_dir = Path(plugin_dir) / "webui"+ has_thumb = any((webui_dir / f"thumbnail.{ext}").is_file() for ext in _thumb_exts)+ if has_thumb:+ continue+ thumb_url = plugin_data.get("thumbnail") or ""+ if not thumb_url:+ from urllib.parse import urlparse+ raw_base = None+ github = plugin_data.get("github") or ""+ if github:+ try:+ parsed = urlparse(github)+ if parsed.netloc == "github.com":+ parts = parsed.path.strip("/").split("/")+ if len(parts) >= 2:+ raw_base = f"https://raw.githubusercontent.com/{parts[0]}/{parts[1]}"+ except Exception:+ pass+ if raw_base:+ thumb_url = f"{raw_base}/main/thumbnail.png"+ if thumb_url:+ _download_thumbnail(thumb_url, plugin_dir)return {"index": index_data, "installed_plugins": installed_keys}diff --git a/plugins/_plugin_installer/webui/install-index.html b/plugins/_plugin_installer/webui/install-index.htmlindex c713498fe..753b4ca09 100644--- a/plugins/_plugin_installer/webui/install-index.html+++ b/plugins/_plugin_installer/webui/install-index.html@@ -69,37 +69,43 @@class="pi-grid"><template x-for="plugin in $store.pluginInstallStore.paginatedPlugins" :key="plugin.key"><button type="button" class="pi-card" @click="$store.pluginInstallStore.openDetail(plugin)">- <div class="pi-card-thumb">- <template x-if="plugin.thumbnail">- <img :src="plugin.thumbnail" :alt="plugin.title" loading="lazy">- </template>- <template x-if="!plugin.thumbnail">- <span class="material-symbols-outlined pi-card-placeholder">extension</span>- </template>-- <template x-if="plugin.installed">- <span class="pi-card-installed-pill">Installed</span>- </template>+ <div class="pi-card-header">+ <div class="pi-card-thumb">+ <template x-if="plugin.thumbnail">+ <img :src="plugin.thumbnail" :alt="plugin.title" loading="lazy">+ </template>+ <template x-if="!plugin.thumbnail">+ <span class="material-symbols-outlined pi-card-placeholder">extension</span>+ </template>+ </div>- <template x-if="plugin.has_update">- <span class="pi-card-update-pill" :class="{ 'pi-card-update-pill-offset': plugin.installed }">New version</span>- </template>- </div>+ <div class="pi-card-heading">+ <h3 class="pi-card-title" x-text="plugin.title || plugin.key"></h3>++ <div class="pi-card-subtitle"+ x-text="$store.pluginInstallStore.getBrowseSubtitle(plugin)">+ </div>- <div class="pi-card-body">- <div class="pi-card-head">- <div class="pi-card-heading">- <h3 class="pi-card-title" x-text="plugin.title || plugin.key"></h3>- <div class="pi-card-subtitle"- x-text="$store.pluginInstallStore.getBrowseSubtitle(plugin)">- </div>+ <div class="pi-card-pills">+ <template x-if="plugin.installed">+ <span class="pi-card-installed-pill">Installed</span>+ </template>+ <template x-if="plugin.has_update">+ <span class="pi-card-update-pill">New version</span>+ </template></div>- <span class="material-symbols-outlined pi-card-arrow">arrow_outward</span>+</div>+ <span class="material-symbols-outlined pi-card-arrow">arrow_outward</span>+ </div>++ <div class="pi-card-body">+<div class="pi-card-desc"x-text="$store.pluginInstallStore.truncate(plugin.description, 110)"></div>+</div><div class="pi-card-footer">@@ -403,17 +409,24 @@box-shadow: 0 12px 30px rgba(0, 0, 0, 0.18);}+ .pi-card-header {+ display: flex;+ align-items: center;+ gap: 0.75rem;+ padding: 0.85rem;+ }+.pi-card-thumb {- position: relative;+ width: 56px;+ height: 56px;+ flex-shrink: 0;display: flex;align-items: center;justify-content: center;- height: 148px;- padding: 0.5rem;- background:- radial-gradient(circle at top, #6b728089, var(--color-panel)),- var(--color-panel);- border-bottom: 1px solid var(--color-border);+ border-radius: 0.5rem;+ overflow: hidden;+ background: var(--color-panel);+ border: 1px solid var(--color-border);}.pi-card-thumb img {@@ -423,65 +436,13 @@}.pi-card-placeholder {- font-size: 4rem;+ font-size: 2rem;color: var(--color-text-muted);}- .pi-card-installed-pill {- position: absolute;- top: 0.75rem;- right: 0.75rem;- padding: 0.24rem 0.5rem;- border-radius: 0.5rem;- background: rgba(34, 197, 94, 0.15);- color: #4ade80;- font-size: 0.72rem;- font-weight: 700;- }-- body.light-mode .pi-card-installed-pill {- background: rgba(34, 197, 94, 0.22);- color: #166534;- }-- .pi-card-update-pill {- position: absolute;- top: 0.75rem;- right: 0.75rem;- padding: 0.24rem 0.5rem;- border-radius: 0.5rem;- background: rgba(59, 130, 246, 0.16);- color: #60a5fa;- font-size: 0.72rem;- font-weight: 700;- }-- body.light-mode .pi-card-update-pill {- background: rgba(59, 130, 246, 0.2);- color: #1d4ed8;- }-- .pi-card-update-pill-offset {- top: 2.35rem;- }-- .pi-card-body {- flex: 1;- display: flex;- flex-direction: column;- gap: 0.8rem;- padding: 1rem;- }-- .pi-card-head {- display: flex;- align-items: flex-start;- justify-content: space-between;- gap: 0.75rem;- }-.pi-card-heading {min-width: 0;+ flex: 1;}.pi-card-title {@@ -492,7 +453,7 @@}.pi-card-subtitle {- margin-top: 0.25rem;+ margin-top: 0.2rem;font-size: 0.82rem;color: var(--color-text-muted);white-space: nowrap;@@ -506,12 +467,59 @@flex-shrink: 0;}+ .pi-card-body {+ flex: 1;+ display: flex;+ flex-direction: column;+ gap: 0.6rem;+ padding: 0 0.85rem 0.85rem;+ }+.pi-card-desc {font-size: 0.88rem;line-height: 1.5;color: var(--color-text-secondary);}+ .pi-card-pills {+ display: flex;+ flex-wrap: wrap;+ padding: var(--spacing-xs) 0;+ gap: 0.4rem;+ }++ .pi-card-pills++ .pi-card-installed-pill {+ display: inline-flex;+ padding: 0.24rem 0.5rem;+ border-radius: 0.5rem;+ background: rgba(34, 197, 94, 0.15);+ color: #4ade80;+ font-size: 0.72rem;+ font-weight: 700;+ }++ body.light-mode .pi-card-installed-pill {+ background: rgba(34, 197, 94, 0.22);+ color: #166534;+ }++ .pi-card-update-pill {+ display: inline-flex;+ padding: 0.24rem 0.5rem;+ border-radius: 0.5rem;+ background: rgba(59, 130, 246, 0.16);+ color: #60a5fa;+ font-size: 0.72rem;+ font-weight: 700;+ }++ body.light-mode .pi-card-update-pill {+ background: rgba(59, 130, 246, 0.2);+ color: #1d4ed8;+ }+.pi-card-footer {display: flex;align-items: center;@@ -575,10 +583,6 @@.pi-grid {grid-template-columns: 1fr;}-- .pi-card-thumb {- height: 164px;- }}</style></body>diff --git a/plugins/_plugin_installer/webui/pluginInstallStore.js b/plugins/_plugin_installer/webui/pluginInstallStore.jsindex 7fbf5e963..bd5906b01 100644--- a/plugins/_plugin_installer/webui/pluginInstallStore.js+++ b/plugins/_plugin_installer/webui/pluginInstallStore.js@@ -515,6 +515,7 @@ const model = {action: "install_git",git_url: plugin.github,plugin_name: plugin.key,+ thumbnail_url: this.getThumbnailUrl(plugin) || "",});if (!data.success) {diff --git a/webui/components/plugins/list/plugin-list.html b/webui/components/plugins/list/plugin-list.htmlindex efa9e93be..f3ce3282d 100644--- a/webui/components/plugins/list/plugin-list.html+++ b/webui/components/plugins/list/plugin-list.html@@ -86,6 +86,12 @@}))" :key="plugin.path || plugin.name"><div class="plugin-card"><div class="plugin-header">+ <template x-if="plugin.thumbnail_url">+ <img class="plugin-thumb"+ :src="plugin.thumbnail_url"+ :alt="plugin.display_name || plugin.name"+ loading="lazy">+ </template><div class="plugin-heading"><div class="plugin-title" x-text="plugin.display_name || plugin.name || '(unnamed plugin)'"></div><code class="plugin-path" x-text="plugin.path"></code>@@ -307,6 +313,16 @@flex: 1 1 auto;}+ .plugin-thumb {+ width: 44px;+ height: 44px;+ border-radius: 0.5rem;+ object-fit: contain;+ flex-shrink: 0;+ background: var(--color-panel);+ border: 1px solid var(--color-border);+ }+.plugin-title {font-weight: 600;font-size: 1rem;