企业官网建设流程全解析

如何5分钟上手Hermes Desktop：Windows、macOS与Linux安装和首次设置完全指南

【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktop

Hermes Desktop 是一款为 Hermes Agent 打造的免费原生桌面应用，让你在一个图形界面里完成 AI 助手的安装、模型配置和日常聊天，彻底告别命令行。它同时支持 Windows、macOS 与 Linux，内置向导式安装流程，即使是零基础的新手也能在 5 分钟内跑通"下载 → 安装 → 配置模型 → 发起第一次对话"的完整链路。这篇 Hermes Desktop 安装教程将带你逐步走完首次设置。

一、下载 Hermes Desktop 安装包

Hermes Desktop 是开源项目，提供三大平台的官方安装包：

项目当前版本为 0.7.4，支持自动更新，安装后无需手动反复下载新版。

💡提示：如果你已经在命令行装过 Hermes Agent，桌面应用会自动检测到~/.hermes目录下的现有安装并直接接管，不会重复下载。

二、首次启动：本地模式还是远程模式？

双击启动后，Hermes Desktop 会先问你一个关键问题：在本地运行 Hermes，还是连接远程的 Hermes API 服务器？

• 本地模式（推荐新手）：应用在~/.hermes下检查是否已有 Hermes，若没有则自动调用官方安装脚本，解析 Git、uv、Python 3.11+ 等依赖，全程带进度条。
• 远程模式：填入远程 API 地址和密钥，验证连接后跳过本地安装，适合已有云端 Hermes 服务的用户。

安装进度、依赖解析、失败重试都在安装页里完成，相关实现可参考 Install.tsx，官方安装脚本入口在 hermes.ts。

三、配置模型提供商：5 种最快上手路径

首次设置的核心一步是选择"模型从哪里来"。Hermes Desktop 支持多提供商，新手可按优先级这样选：

1. OpenRouter—— 一个 API 打通 200+ 模型，官方推荐；
2. Anthropic / OpenAI / Google (Gemini)—— 有官方账号直接填 Key 即可；
3. 本地 LLM—— 用 LM Studio、Ollama、vLLM 等 OpenAI 兼容端点，完全免费且无需 API Key，只需保证本地服务已启动。

密钥默认保存在~/.hermes/.env，开箱即用，无需额外配置。

配置完成后，建议顺手在 Models 页面保存常用模型，方便以后一键切换：

四、认识主界面：12 个功能面板速览

设置完成后即进入主工作区。左侧导航栏就是 Hermes Desktop 的全部功能地图：

• Chat：流式聊天，支持 22 个斜杠命令（/new、/usage、/model、/memory等）、Token 用量与费用实时显示；
• Sessions：全文搜索历史会话、按日期分组、随时续聊；
• Profiles：多套完全隔离的 Hermes 环境，一键切换；
• Skills / Tools：浏览安装技能，开关 14 种工具集（浏览器、终端、图像生成、TTS 等）；
• Memory：查看和编辑 Agent 的记忆条目；
• Schedules：Cron 定时任务，支持 15 种推送目标；
• Gateway：Telegram、Discord、Slack、微信、飞书等 16 个消息网关；
• Settings：备份/导入、日志查看、主题与网络设置。

五、发起第一次对话：3 步完成

1. 在 Chat 页输入框直接提问，响应以 SSE 流式逐字呈现；
2. 输入/唤起命令面板，试试/help查看全部命令；
3. 打开会话管理面板回顾与搜索历史对话。

六、常见问题速查

七、延伸阅读

• 完整功能清单与工作原理：README.md、README.zh-CN.md
• 主进程架构说明：src/main/
• 远程访问与 SSH 隧道进阶玩法：docs/SSH-TUNNEL-VPS.md

至此，Hermes Desktop 的下载、安装、模型配置与首次对话已全部打通。接下来可以探索 Discover 页面安装新技能，让它变得更强：

【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktop