Skip to content

Agent Zero AI framework

plugins: thumbnails in plugin list and hub

Alessandro6aaa435a1d76
diff --git a/helpers/plugins.py b/helpers/plugins.py
index 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}"
+ break
current_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.py
index 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 None
plugin_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.py
index 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) -> dic
pass
-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 hook
try:
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.html
index 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.js
index 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.html
index 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;