[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2452":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":13,"lastSyncTime":29,"discoverSource":30},2452,"Hermes-One-Click","Devsoul2026\u002FHermes-One-Click","Devsoul2026","Hermes One-Click: Windows desktop client for Hermes — one-click setup, Tauri + embedded Python. Build from source with clear docs.",null,"Python",140,25,2,4,0,1,5,46,3,4.24,"MIT License",false,"main",true,[],"2026-06-12 02:00:41","# Hermes One-Click\n\n![Hermes One-Click Demo](Example.gif)\n\n\u003Cp align=\"center\">\u003Ca href=\"#中文版\">中文\u003C\u002Fa> · \u003Ca href=\"#english\">English\u003C\u002Fa>\u003C\u002Fp>\n\n---\n\n## 中文版\n\nHermes One-Click 是一个面向 Windows 的 Hermes 可视化桌面包。它把 `hermes-agent`、`hermes-webui`、原生 WebView2 壳、便携 Python 运行时、Node 运行时、WebView2 Fixed Runtime、内置技能和便携工具一起打进安装包，让最终用户安装后无需配置开发环境，双击 `HermesWebUI.exe` 即可打开可视化应用。\n\n### 🆕 V0.11.0 更新日志\n\n1. **同步 Hermes Agent 0.14.0** — 正式支持原生 Windows 终端后端，彻底告别 WSL 依赖，终端体验更稳定、更流畅。\n2. **修复用户反馈的多项 BUG** — 感谢各位通过抖音、知识星球、GitHub Issues 等渠道积极反馈，本版已完成一批稳定性修复。\n3. **新增右侧抽屉式工作区文件浏览** — 在聊天界面右侧新增一个常驻「文件」入口，点击即可展开查看当前工作区的目录结构与文件，方便随时确认工作区是否配置正确。\n4. **新增冒爸技能市场** — 顶部栏直达「冒爸技能市场」，持续上新实用 AI 技能包，一键安装即可扩展 Hermes 能力边界。\n\n---\n\n### 交流与支持\n\n- **抖音：@冒爸聊AI** — 分享 AI Agent 实战内容（在抖音内搜索「冒爸聊AI」关注）。\n- **知识星球「冒爸聊 AI」** — 深度交流、独家技能包、1 对 1 咨询与企业需求对接。\n- **[GitHub Issues](https:\u002F\u002Fgithub.com\u002FDevsoul2026\u002FHermes-One-Click\u002Fissues)** — 技术问题与功能建议请在此提交，便于跟踪与协作。\n\n### AI 大航海\n\n> 我们不只是做工具，我们在建生态。无论你是个人开发者、企业决策者，还是想进入 AI 行业的普通人——这里有你上船的位置。\n\nHermes One-Click 基于 **MIT** 协议开源，可免费使用。若本项目对你有帮助，欢迎在 GitHub 上点亮一颗 **Star**，这对我们是很大的鼓励。\n\n---\n\n### 仓库结构\n\n- `hermes-agent\u002F`：Hermes agent、CLI、工具、技能系统和前端 dashboard 源码。\n- `hermes-webui\u002F`：本地 WebUI 服务、API、静态资源和会话管理。\n- `packaging\u002Fwindows\u002Flauncher-native\u002F`：Windows 原生 WebView2 启动器项目，负责启动 WebUI、等待本地端口打开并进入桌面窗口。\n- `packaging\u002Fwindows\u002Fhermes-installer-staging.iss`：Inno Setup 安装包脚本。\n- `scripts\u002FBuild-Staging.ps1`：从源码生成 `_staging\u002FHermes` 完整运行目录。\n- `vendor\u002F`：本地下载的离线运行时和便携工具缓存，默认不提交到 Git。\n- `_staging\u002F`、`_dist\u002F`：构建输出目录，默认不提交到 Git。\n\n### 构建环境\n\n推荐在 Windows 10\u002F11 x64 上构建。\n\n必需工具：\n\n- PowerShell\n- Git for Windows，提供 Git Bash，前端构建脚本会用到 `rm` \u002F `cp`\n- Python 3.11 或更高版本\n- Node.js + npm\n- .NET 8 SDK\n- Inno Setup 6\n\n可用 `winget` 安装常见依赖：\n\n```powershell\nwinget install --id Git.Git -e\nwinget install --id OpenJS.NodeJS.LTS -e\nwinget install --id Python.Python.3.12 -e\nwinget install --id Microsoft.DotNet.SDK.8 -e\nwinget install --id JRSoftware.InnoSetup -e\n```\n\n### 准备离线运行时\n\n为了让用户安装后不再依赖系统 WebView2，需要下载 Microsoft WebView2 Fixed Version Runtime。当前构建使用的是 `147.0.3912.98 x64`：\n\n```powershell\nNew-Item -ItemType Directory -Force -Path \".\\vendor\" | Out-Null\ncurl.exe -L --fail -o \".\\vendor\\Microsoft.WebView2.FixedVersionRuntime.147.0.3912.98.x64.cab\" \"https:\u002F\u002Fmsedge.sf.dl.delivery.mp.microsoft.com\u002Ffilestreamingservice\u002Ffiles\u002F01f18384-38a3-449b-ac04-2aa1777b26fe\u002FMicrosoft.WebView2.FixedVersionRuntime.147.0.3912.98.x64.cab\"\n```\n\n如果这个 Microsoft 直链过期，请到 [Microsoft Edge WebView2](https:\u002F\u002Fdeveloper.microsoft.com\u002Fmicrosoft-edge\u002Fwebview2\u002F) 下载 Fixed Version Runtime，选择 `x64`，然后把 `.cab` 文件放到 `vendor\u002F`。\n\n### 准备 Skillhub 中国源\n\n安装包可以内置 Skillhub CLI，作为中国网络环境下优先使用的技能商店来源。`vendor\u002F` 默认不提交到 Git，因此从干净仓库构建时需要先拉取一次：\n\n```powershell\ncurl.exe -L --fail --retry 8 --retry-delay 5 -o \".\\vendor\\skillhub-latest.tar.gz\" \"https:\u002F\u002Fskillhub-1388575217.cos.ap-guangzhou.myqcloud.com\u002Finstall\u002Flatest.tar.gz\"\n\nif (Test-Path \".\\vendor\\skillhub-kit\") { Remove-Item -Recurse -Force \".\\vendor\\skillhub-kit\" }\nif (Test-Path \".\\vendor\\skillhub\") { Remove-Item -Recurse -Force \".\\vendor\\skillhub\" }\nNew-Item -ItemType Directory -Force -Path \".\\vendor\\skillhub-kit\", \".\\vendor\\skillhub\" | Out-Null\n\ntar -xzf \".\\vendor\\skillhub-latest.tar.gz\" -C \".\\vendor\\skillhub-kit\"\nCopy-Item \".\\vendor\\skillhub-kit\\cli\\skills_store_cli.py\" \".\\vendor\\skillhub\\skills_store_cli.py\" -Force\nCopy-Item \".\\vendor\\skillhub-kit\\cli\\skills_upgrade.py\" \".\\vendor\\skillhub\\skills_upgrade.py\" -Force\nCopy-Item \".\\vendor\\skillhub-kit\\cli\\version.json\" \".\\vendor\\skillhub\\version.json\" -Force\nCopy-Item \".\\vendor\\skillhub-kit\\cli\\metadata.json\" \".\\vendor\\skillhub\\metadata.json\" -Force\n```\n\n然后创建 Windows wrapper：\n\n```powershell\n@'\n@echo off\nsetlocal\nset \"SCRIPT_DIR=%~dp0\"\nset \"PYTHON_EXE=%SCRIPT_DIR%..\\..\\runtime\\python\\python.exe\"\nif exist \"%PYTHON_EXE%\" goto run_cli\nset \"PYTHON_EXE=%SCRIPT_DIR%..\\..\\runtime\\venv\\Scripts\\python.exe\"\nif exist \"%PYTHON_EXE%\" goto run_cli\nfor %%P in (python.exe py.exe) do (\n  where %%P >nul 2>nul && set \"PYTHON_EXE=%%P\" && goto run_cli\n)\necho Error: bundled Python runtime not found. 1>&2\nexit \u002Fb 1\n:run_cli\nset \"SKILLHUB_SKIP_SELF_UPGRADE=1\"\n\"%PYTHON_EXE%\" \"%SCRIPT_DIR%skills_store_cli.py\" --skip-self-upgrade %*\nexit \u002Fb %ERRORLEVEL%\n'@ | Set-Content -Path \".\\vendor\\skillhub\\skillhub.cmd\" -Encoding ascii\n```\n\n### 从根目录生成 exe 安装包\n\n在仓库根目录执行：\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File \".\\scripts\\Build-Staging.ps1\" -Clean -DownloadNode -WebView2FixedRuntimePath \".\\vendor\\Microsoft.WebView2.FixedVersionRuntime.147.0.3912.98.x64.cab\"\n```\n\n然后编译安装包：\n\n```powershell\n& \"$env:LOCALAPPDATA\\Programs\\Inno Setup 6\\ISCC.exe\" \".\\packaging\\windows\\hermes-installer-staging.iss\"\n```\n\n默认产物：\n\n```text\n.\\_dist\\HermesOneClickSetup-Devsoul-0.11.0-dev.exe\n```\n\n安装包内会包含：\n\n- `HermesWebUI.exe`\n- `runtime\u002Fpython` 便携 Python 运行环境\n- `runtime\u002Fwebview2` WebView2 Fixed Runtime\n- `node\u002Fnode.exe`\n- `tools\u002Fbin\u002Fskillhub.cmd`\n- `tools\u002Fbin\u002Frg.exe`，如果构建机能找到 `rg`\n- `hermes-agent\u002Fskills` 内置技能，包括 `ddgr-2.2`\n\n### 可选 Hermes Tweet X\u002FTwitter 插件\n\nHermes One-Click 启动后，如果用户需要原生 Hermes Agent 的 X\u002FTwitter 插件路线，可以在 Hermes 环境里安装 [Hermes Tweet](https:\u002F\u002Fgithub.com\u002FXquik-dev\u002Fhermes-tweet)：\n\n```powershell\nhermes plugins install Xquik-dev\u002Fhermes-tweet --enable\n```\n\n设置 `XQUIK_API_KEY` 后，Hermes Agent 可以通过 `tweet_explore` scrape\u002Fsearch tweets、search Twitter\u002FX，通过 `tweet_read` read tweet replies、look up users、monitor tweets，通过 `tweet_action` export followers。post tweets、post replies、send DMs 和其他 automate X actions 应继续由用户明确确认后再执行，适合把社媒监听和发布流程接入 One-Click 桌面工作流。\n\n### 启动器行为\n\n`HermesWebUI.exe` 会启动内置的 `runtime\u002Fpython\u002Fpython.exe`，运行 `app\u002Fhermes-webui\u002Fserver.py`，并把 WebUI 的输出写入：\n\n```text\n%LOCALAPPDATA%\\Hermes\\logs\\webui.log\n```\n\n启动器会先等待 `127.0.0.1:8787` 本地端口打开，然后立即进入 WebView2 窗口。`\u002Fapi\u002Fsettings`、网关、日志和初始化配置等接口由前端继续加载，不会阻塞桌面窗口启动。这样可以减少低性能机器、首次杀软扫描或配置读取较慢时的误报超时。\n\n### 常见问题\n\n如果 `Build-Staging.ps1 -Clean` 删除 `_staging` 失败，通常是旧的 `HermesWebUI.exe`、`python.exe` 或 gateway 进程仍在运行。关闭可视化窗口后重试，必要时在任务管理器中结束相关进程。\n\n如果前端构建失败并提示 `rm` 或 `cp` 不存在，请安装 Git for Windows。脚本会自动把 npm project 的 `script-shell` 设置为 Git Bash。\n\n如果安装包图标没有刷新，请确认使用的是最新输出文件 `HermesOneClickSetup-Devsoul-0.11.0-dev.exe`。Windows Explorer 可能会缓存旧的同名 exe 图标。\n\n如果用户反馈 `Hermes One-Click WebUI did not open port http:\u002F\u002F127.0.0.1:8787\u002F within 120 seconds`，请先收集 `%LOCALAPPDATA%\\Hermes\\logs\\webui.log`。常见原因包括杀软拦截\u002F扫描内置 Python、旧进程占用 `8787`、安装目录文件被拦截或首次启动机器性能较慢。\n\n---\n\n## English\n\nHermes One-Click is a Windows desktop distribution of Hermes. It packages `hermes-agent`, `hermes-webui`, a native WebView2 launcher, a portable Python runtime, Node runtime, WebView2 Fixed Runtime, bundled skills, and portable tools into one installer. End users can install it and launch the visual app by double-clicking `HermesWebUI.exe`.\n\n### 🆕 V0.11.0 Release Notes\n\n1. **Synced with Hermes Agent 0.14.0** — Native Windows terminal backend is now fully supported, eliminating the WSL dependency for a smoother, more reliable terminal experience.\n2. **Multiple bug fixes based on community feedback** — Thanks to everyone who reported issues via Douyin, 知识星球, and GitHub Issues. A batch of stability improvements lands in this release.\n3. **Right-side workspace file drawer** — A persistent \"Files\" tab now lives on the right edge of the chat view. Click it to instantly expand and browse the current workspace directory, making it easy to verify your workspace setup at a glance.\n4. **Maoba Skill Market** — A new \"Skill Market\" shortcut in the top bar links directly to the curated Maoba skill store, where you can discover and install AI skill packs to extend Hermes with one click.\n\n---\n\n### Connect & support\n\n- **Douyin: @冒爸** — daily AI Agent tips and walkthroughs (search “冒爸” in the Douyin app).\n- **知识星球「冒爸聊 AI」** — deeper discussions, exclusive skill packs, 1:1 consulting, and enterprise introductions.\n- **[GitHub Issues](https:\u002F\u002Fgithub.com\u002FDevsoul2026\u002FHermes-One-Click\u002Fissues)** — technical questions and feature requests belong here for tracking and collaboration.\n\n### Beyond the tool\n\n> We are not only shipping a tool — we are building an ecosystem. Whether you are an indie developer, a business decision-maker, or someone stepping into AI — there is a place for you on board.\n\nHermes One-Click is open source under the **MIT** license and free to use. If you find it useful, please leave us a **Star** on GitHub — it means a lot.\n\n---\n\n### Repository Layout\n\n- `hermes-agent\u002F`: Hermes agent, CLI, tools, skill system, and dashboard source.\n- `hermes-webui\u002F`: local WebUI server, APIs, static assets, and session handling.\n- `packaging\u002Fwindows\u002Flauncher-native\u002F`: native Windows WebView2 launcher project that starts WebUI, waits for the local port, and opens the desktop window.\n- `packaging\u002Fwindows\u002Fhermes-installer-staging.iss`: Inno Setup installer script.\n- `scripts\u002FBuild-Staging.ps1`: builds the complete `_staging\u002FHermes` runtime directory.\n- `vendor\u002F`: local runtime\u002Ftool cache, ignored by Git.\n- `_staging\u002F`, `_dist\u002F`: generated build outputs, ignored by Git.\n\n### Requirements\n\nBuild on Windows 10\u002F11 x64.\n\nRequired tools:\n\n- PowerShell\n- Git for Windows, including Git Bash\n- Python 3.11+\n- Node.js + npm\n- .NET 8 SDK\n- Inno Setup 6\n\nInstall common dependencies with `winget`:\n\n```powershell\nwinget install --id Git.Git -e\nwinget install --id OpenJS.NodeJS.LTS -e\nwinget install --id Python.Python.3.12 -e\nwinget install --id Microsoft.DotNet.SDK.8 -e\nwinget install --id JRSoftware.InnoSetup -e\n```\n\n### Prepare Offline Runtimes\n\nDownload WebView2 Fixed Version Runtime:\n\n```powershell\nNew-Item -ItemType Directory -Force -Path \".\\vendor\" | Out-Null\ncurl.exe -L --fail -o \".\\vendor\\Microsoft.WebView2.FixedVersionRuntime.147.0.3912.98.x64.cab\" \"https:\u002F\u002Fmsedge.sf.dl.delivery.mp.microsoft.com\u002Ffilestreamingservice\u002Ffiles\u002F01f18384-38a3-449b-ac04-2aa1777b26fe\u002FMicrosoft.WebView2.FixedVersionRuntime.147.0.3912.98.x64.cab\"\n```\n\nIf the direct Microsoft URL expires, download the Fixed Version Runtime from [Microsoft Edge WebView2](https:\u002F\u002Fdeveloper.microsoft.com\u002Fmicrosoft-edge\u002Fwebview2\u002F), choose `x64`, and place the `.cab` file under `vendor\u002F`.\n\nTo bundle the China Skillhub CLI, download and unpack the Skillhub kit into `vendor\u002Fskillhub`, then provide `vendor\u002Fskillhub\u002Fskillhub.cmd`. See the Chinese section above for the exact PowerShell commands.\n\n### Build the Installer from Repository Root\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File \".\\scripts\\Build-Staging.ps1\" -Clean -DownloadNode -WebView2FixedRuntimePath \".\\vendor\\Microsoft.WebView2.FixedVersionRuntime.147.0.3912.98.x64.cab\"\n```\n\nThen compile the installer:\n\n```powershell\n& \"$env:LOCALAPPDATA\\Programs\\Inno Setup 6\\ISCC.exe\" \".\\packaging\\windows\\hermes-installer-staging.iss\"\n```\n\nOutput:\n\n```text\n.\\_dist\\HermesOneClickSetup-Devsoul-0.11.0-dev.exe\n```\n\nThe installer includes the native launcher, bundled Python environment, WebView2 Fixed Runtime, Node runtime, Skillhub CLI when prepared, and bundled skills such as `ddgr-2.2`.\n\n### Optional Hermes Tweet X\u002FTwitter Plugin\n\nAfter Hermes One-Click starts, users who need a native Hermes Agent X\u002FTwitter plugin can install [Hermes Tweet](https:\u002F\u002Fgithub.com\u002FXquik-dev\u002Fhermes-tweet) inside the Hermes environment:\n\n```powershell\nhermes plugins install Xquik-dev\u002Fhermes-tweet --enable\n```\n\nAfter setting `XQUIK_API_KEY`, Hermes Agent can use `tweet_explore` to scrape\u002Fsearch tweets and search Twitter\u002FX, `tweet_read` to read tweet replies, look up users, and monitor tweets, and `tweet_action` to export followers. Keep post tweets, post replies, send DMs, and other automate X actions behind explicit user confirmation when connecting social monitoring or publishing workflows to the One-Click desktop app.\n\n### Launcher Behavior\n\n`HermesWebUI.exe` starts the bundled `runtime\u002Fpython\u002Fpython.exe`, runs `app\u002Fhermes-webui\u002Fserver.py`, and writes WebUI output to:\n\n```text\n%LOCALAPPDATA%\\Hermes\\logs\\webui.log\n```\n\nThe launcher waits for `127.0.0.1:8787` to accept connections and then opens the WebView2 window. `\u002Fapi\u002Fsettings`, gateway status, logs, and onboarding state continue loading from the frontend, so slower first-run initialization does not block the desktop window.\n\nIf a user sees `Hermes One-Click WebUI did not open port http:\u002F\u002F127.0.0.1:8787\u002F within 120 seconds`, collect `%LOCALAPPDATA%\\Hermes\\logs\\webui.log` first. Common causes are antivirus scanning\u002Fblocking the bundled Python runtime, a stale process occupying port `8787`, blocked install files, or very slow first launch on low-end machines.\n","Hermes One-Click 是一个面向 Windows 的 Hermes 可视化桌面包，旨在简化 Hermes 的安装和使用流程。其核心功能包括将 `hermes-agent`、`hermes-webui` 以及必要的运行时环境（如 Python 和 Node.js）打包成一个易于部署的安装包，用户只需双击即可启动可视化界面，无需额外配置开发环境。此外，它还支持原生 Windows 终端后端，提供了更稳定的终端体验，并内置了技能市场和文件浏览功能，方便用户管理和扩展 Hermes 的能力。此项目特别适合希望快速上手 Hermes 而又不熟悉复杂环境配置的开发者或企业使用。","2026-06-11 02:49:59","CREATED_QUERY"]