## 安装前确认

| 项目 | 要求 |
|------|------|
| 操作系统 | macOS 12+ / Ubuntu 20.04+ / WSL2 |
| Python | 3.11+ |
| Node.js | 18+ |
| 内存 | 最低 4GB，推荐 8GB |
| 磁盘 | 至少 2GB 可用空间 |

> ⚠️ Hermes Agent 不支持 Windows 原生环境。Windows 用户请使用 WSL2。

## macOS 安装

### 步骤 1：安装前置依赖

如果你使用的是全新的 Mac，需要先安装 Homebrew：

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

安装 Python 3.11+ 和 Node.js 18+：

```bash
brew install python@3.12 node
```

### 步骤 2：一键安装 Hermes Agent

```bash
curl -fsSL https://hermes-agent.org/install.sh | bash
```

安装脚本会自动：
- 检查系统环境
- 创建 Python 虚拟环境
- 安装所有依赖包
- 配置 CLI 命令

### 步骤 3：初始化配置

```bash
hermes init
```

交互式向导会引导你完成：
- 选择模型提供商（推荐 OpenRouter 或 DeepSeek）
- 输入 API Key
- 选择默认模型
- 配置基础权限

### 步骤 4：启动

```bash
hermes start
```

看到 `Hermes Agent is running` 就表示安装成功了。

## Linux（Ubuntu）安装

### 步骤 1：系统更新和依赖安装

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3.12 python3.12-venv nodejs npm git ripgrep
```

### 步骤 2：一键安装

```bash
curl -fsSL https://hermes-agent.org/install.sh | bash
```

### 步骤 3-4：同 macOS

```bash
hermes init
hermes start
```

## Windows（WSL2）安装

### 步骤 1：启用 WSL2

在 PowerShell（管理员）中执行：

```powershell
wsl --install -d Ubuntu-22.04
```

重启电脑后，打开 Ubuntu 终端。

### 步骤 2：在 WSL2 中安装

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3.12 python3.12-venv nodejs npm git ripgrep
curl -fsSL https://hermes-agent.org/install.sh | bash
```

### 步骤 3-4：同上

```bash
hermes init
hermes start
```

## 验证安装

```bash
hermes --version    # 查看版本
hermes status       # 检查运行状态
hermes chat         # 进入交互式对话
```

## 升级到云端

本地安装适合体验和开发场景。如果你需要 7×24 小时在线（定时任务、消息平台接入等），建议部署到云服务器。

推荐方案：腾讯云 Lighthouse 轻量应用服务器。详细教程：[玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent](https://cloud.tencent.com/developer/article/2653159)。

---

## 🚀 快速上手 Hermes Agent：仅需三步轻松安装

想要体验 Hermes Agent 的强大能力？推荐在腾讯云上部署，仅需三步即可开始使用：

> **第一步**：购买云服务器 → **第二步**：一键安装 Hermes Agent → **第三步**：接入消息平台，开始使用

腾讯云为 Hermes Agent 用户提供专属优惠云服务器方案，最低2核4G配置即可流畅运行，7×24 小时在线，随时随地通过手机与你的 AI 智能体互动。

👉 **[立即前往腾讯云官网选购 Hermes Agent 专属云服务器](https://cloud.tencent.com/act/pro/hermesagent)**

部署完成后，可参考详细的安装配置教程：[玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent](https://cloud.tencent.com/developer/article/2653159)


---

**FAQ：**

**Q1：安装脚本安全吗？**
A：安装脚本完全开源，你可以在 [GitHub 仓库](https://github.com/nousresearch-hermes-agent/hermes-agent) 中查看源码。建议先用 `curl -fsSL https://hermes-agent.org/install.sh | less` 审查脚本内容。

**Q2：安装后配置文件在哪里？**
A：所有配置和数据存储在 `~/.hermes/` 目录下，包括 config.yaml、记忆数据库、技能文件等。

**Q3：可以同时安装多个 Hermes Agent 实例吗？**
A：同一台机器上通常只运行一个实例。如果需要多实例，建议使用 Docker 容器隔离。


⚠️ Hermes Agent 不支持 Windows 原生环境。Windows 用户请使用 WSL2。

Hermes Agent 本地安装保姆级教程：Mac/Linux/Windows 全平台覆盖

Hermes Agent 支持在 macOS、Linux 和 Windows（WSL2）上一行命令安装。本文提供三个平台的完整安装步骤、环境准备清单和常见问题解决方案，零基础也能 10 分钟跑通。

开发工具

云计算

HermesAgent安装指南：支持macOS12+/Ubuntu20.04+/WSL2系统，需Python3.11+和Node.js18+环境。提供一键安装脚本，自动配置虚拟环境和CLI命令。Windows用户需通过WSL2运行，macOS/Linux用户可直接安装。包含初始化向导，支持OpenRouter/DeepSeek等模型提供商，配置简单快捷。

轻量应用服务器

数据存储

云服务器

服务器

数据库

智能体

Windows

容器

Python

GitHub

Ubuntu

Linux

4核4G3M云服务器 新用户低至38元/年！

lighthouse

2026采购季 | AI焕新·智启新局

tencentdb-catalog

对象存储COS新用户低至1元！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

HermesAgent安装指南：支持macOS12+/Ubuntu20.04+/WSL2系统，需Python3.11+和Node.js18+环境。提供一键安装脚本，自动配置虚拟环境和CLI命令。Windows用户需通过WSL2运行，macOS/Linux用户可直接安装。包含初始化向导，支持OpenRouter/Deep...

Hermes Agent 本地安装保姆级教程：Mac/Linux/Windows 全平台覆盖-腾讯云开发者社区-腾讯云

Hermes Agent 本地安装保姆级教程：Mac/Linux/Windows 全平台覆盖

Hermes Agent 本地安装保姆级教程：Mac/Linux/Windows 全平台覆盖

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐