# Hermes Setup Skill

> hermes-setup-skill: Deploy Hermes Agent via coding agents (Claude Code, Codex, OpenCode, Cursor, Windsurf) — no TTY needed, remote SSH automation, 14 LLM providers, 14 messaging platforms (Telegram, Discord, Slack), MCP tools, self-hosting made easy

- **Type:** MCP server
- **Install:** `agentstack add mcp-hqhq1025-hermes-setup-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hqhq1025](https://agentstack.voostack.com/s/hqhq1025)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hqhq1025](https://github.com/hqhq1025)
- **Source:** https://github.com/hqhq1025/hermes-setup-skill
- **Website:** https://github.com/hqhq1025/hermes-setup-skill

## Install

```sh
agentstack add mcp-hqhq1025-hermes-setup-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# hermes-setup-skill

[English](#english) | [中文](#中文)

---

## What This Is

A skill that lets your coding agent (Claude Code, Codex, OpenCode, etc.) deploy [Hermes Agent](https://github.com/NousResearch/hermes-agent) for you — install, configure, and launch, all through conversation.

Instead of manually running `hermes setup` in a terminal, you just tell your AI: **"Deploy Hermes Agent on my server"** — it handles the rest.

## Install the Skill

Tell your coding agent:

> Install the hermes-setup-skill from https://github.com/hqhq1025/hermes-setup-skill

Or if your agent needs a specific command:

```bash
# Claude Code
git clone https://github.com/hqhq1025/hermes-setup-skill.git ~/.claude/skills/hermes-setup-skill

# Codex / Multi-agent
git clone https://github.com/hqhq1025/hermes-setup-skill.git ~/.agents/skills/hermes-setup-skill
```

That's it. No manual config. Your agent will discover and use the skill automatically.

## Use the Skill

Just talk to your coding agent naturally:

- *"Help me deploy Hermes Agent on my server"*
- *"Set up Hermes on ssh user@myserver"*
- *"Configure Hermes with Telegram and Discord"*
- *"帮我在服务器上部署 Hermes Agent"*

The agent will:
1. Ask you a few questions (provider, platforms, API keys)
2. SSH into your server (if remote)
3. Install and configure everything
4. Launch the gateway service
5. Verify it works

## Why Not Just `hermes setup`?

| | `hermes setup` | This Skill |
|---|---|---|
| Requires interactive TTY | Yes | No |
| Remote deployment via SSH | Manual `ssh -t` | Fully automated |
| Built-in troubleshooting | No | Yes |
| Works with coding agents | No (TTY-only) | Designed for it |

## Coverage

**14 Model Providers** — OpenRouter, GitHub Copilot, Gemini, Anthropic, Nous Portal, Z.AI, Kimi, MiniMax, DeepSeek, Hugging Face, Alibaba/Qwen, Ollama, Custom

**14 Messaging Platforms** — Telegram, Discord, Slack, Matrix, Mattermost, WhatsApp, Signal, Email, DingTalk, Feishu/Lark, WeCom, Weixin/WeChat, BlueBubbles, Webhooks

**Tools** — Web search (Exa, Tavily, Parallel), Firecrawl, FAL, Browserbase, Camofox, Browser Use, STT/TTS (5 providers), X/Twitter, Home Assistant, Honcho, MCP

**OS** — Linux, macOS, WSL2, Windows (PowerShell), Termux/Android

## FAQ

### How do I deploy Hermes Agent with Claude Code?

Install the skill by running `git clone https://github.com/hqhq1025/hermes-setup-skill.git ~/.claude/skills/hermes-setup-skill`, then tell Claude Code "Deploy Hermes Agent on my server." The skill handles installation, configuration of your chosen LLM provider and messaging platforms, and launches the service — all through natural conversation, no manual terminal work required.

### Does hermes-setup-skill work with remote servers?

Yes. Unlike `hermes setup` which requires an interactive TTY session, this skill fully automates remote deployment over SSH. Just say "Set up Hermes on ssh user@myserver" and the coding agent connects, installs dependencies, configures environment variables, and launches the gateway — no need for `ssh -t` or manual intervention.

### Which AI providers does hermes-setup-skill support?

The skill supports 14 model providers: OpenRouter, GitHub Copilot, Gemini, Anthropic, Nous Portal, Z.AI, Kimi, MiniMax, DeepSeek, Hugging Face, Alibaba/Qwen, Ollama, and custom OpenAI-compatible endpoints. It handles all provider-specific authentication flows including GitHub Copilot OAuth device flow automatically.

### How is this different from hermes setup?

The built-in `hermes setup` command requires an interactive TTY terminal and cannot run inside coding agents. hermes-setup-skill is designed specifically for AI-driven deployment — it works without TTY, automates SSH remote deployment, includes built-in troubleshooting for common issues (Discord Intents, Copilot OAuth, systemd linger), and supports all major coding agents.

### Does it work with Cursor or Windsurf?

Yes. hermes-setup-skill works with any coding agent that supports skill discovery, including Claude Code, Codex, OpenCode, Cursor, and Windsurf. Clone the repo into your agent's skill directory and the agent will automatically detect and use it for Hermes Agent deployment tasks.

### Which messaging platforms are supported?

The skill supports 14 messaging platforms: Telegram, Discord, Slack, Matrix, Mattermost, WhatsApp, Signal, Email, DingTalk, Feishu/Lark, WeCom, Weixin/WeChat, BlueBubbles, and Webhooks. You can configure multiple platforms in a single deployment session, and the skill handles each platform's specific bot setup requirements.

## Contributing

Issues and PRs welcome. If you find a missing platform, incorrect env var, or better setup flow, please contribute.

## License

MIT

---

## 这是什么

一个让你的 coding agent（Claude Code、Codex、OpenCode 等）帮你自动部署 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 的 Skill —— 安装、配置、启动，全部通过对话完成。

不用手动在终端里跑 `hermes setup`，你只需要跟 AI 说一句：**"帮我在服务器上部署 Hermes Agent"**，它会搞定一切。

## 安装 Skill

跟你的 coding agent 说：

> 帮我安装 hermes-setup-skill，地址是 https://github.com/hqhq1025/hermes-setup-skill

或者如果你的 agent 需要具体命令：

```bash
# Claude Code
git clone https://github.com/hqhq1025/hermes-setup-skill.git ~/.claude/skills/hermes-setup-skill

# Codex / 其他 agent
git clone https://github.com/hqhq1025/hermes-setup-skill.git ~/.agents/skills/hermes-setup-skill
```

搞定。不需要手动配置任何东西。你的 agent 会自动发现并使用这个 Skill。

## 使用 Skill

跟你的 coding agent 自然语言聊就行：

- *"帮我在 a100 服务器上部署 Hermes Agent"*
- *"配置 Hermes 连接 Telegram 和飞书"*
- *"Deploy Hermes on ssh user@myserver"*
- *"Set up Hermes with Discord and Slack"*

Agent 会：
1. 问你几个问题（选模型提供商、消息平台、填 API key）
2. SSH 到你的服务器（如果是远程部署）
3. 安装并配置所有内容
4. 启动 Gateway 服务
5. 验证是否正常工作

## 为什么不直接用 `hermes setup`？

| | `hermes setup` | 这个 Skill |
|---|---|---|
| 需要交互终端 | 是 | 不需要 |
| 远程部署 | 需要手动 `ssh -t` | 全自动 |
| 内置踩坑排查 | 没有 | 有（Copilot OAuth、Discord Intent、linger 等） |
| 支持 coding agent | 不支持（仅 TTY） | 专为此设计 |

## 覆盖范围

**14 个模型提供商** — OpenRouter、GitHub Copilot、Gemini、Anthropic、Nous Portal、Z.AI、Kimi、MiniMax、DeepSeek、Hugging Face、Alibaba/Qwen、Ollama、自定义

**14 个消息平台** — Telegram、Discord、Slack、Matrix、Mattermost、WhatsApp、Signal、Email、钉钉、飞书、企业微信、微信、BlueBubbles、Webhooks

**工具** — 网页搜索（Exa、Tavily、Parallel）、Firecrawl、FAL、Browserbase、Camofox、Browser Use、语音 STT/TTS（5 种）、X/Twitter、Home Assistant、Honcho、MCP

**操作系统** — Linux、macOS、WSL2、Windows（PowerShell）、Termux/Android

## 常见问题

### 如何用 Claude Code 部署 Hermes Agent？

运行 `git clone https://github.com/hqhq1025/hermes-setup-skill.git ~/.claude/skills/hermes-setup-skill` 安装 Skill，然后跟 Claude Code 说"帮我在服务器上部署 Hermes Agent"。Skill 会自动处理安装、配置你选择的 LLM 提供商和消息平台、启动服务——全程通过自然语言对话完成，无需手动操作终端。

### hermes-setup-skill 支持远程服务器吗？

支持。与需要交互终端的 `hermes setup` 不同，这个 Skill 完全自动化 SSH 远程部署。只需说"帮我在 ssh user@myserver 上部署 Hermes"，coding agent 会自动连接服务器、安装依赖、配置环境变量并启动 Gateway——不需要 `ssh -t` 或任何手动操作。

### hermes-setup-skill 支持哪些 AI 提供商？

支持 14 个模型提供商：OpenRouter、GitHub Copilot、Gemini、Anthropic、Nous Portal、Z.AI、Kimi、MiniMax、DeepSeek、Hugging Face、Alibaba/Qwen、Ollama 以及自定义 OpenAI 兼容端点。自动处理所有提供商特定的认证流程，包括 GitHub Copilot OAuth 设备授权流程。

### 这和 hermes setup 有什么区别？

内置的 `hermes setup` 命令需要交互终端（TTY），无法在 coding agent 中运行。hermes-setup-skill 专为 AI 驱动的部署设计——无需 TTY、自动化 SSH 远程部署、内置常见问题排查（Discord Intents、Copilot OAuth、systemd linger 等），并支持所有主流 coding agent。

### 支持 Cursor 或 Windsurf 吗？

支持。hermes-setup-skill 兼容所有支持 Skill 发现机制的 coding agent，包括 Claude Code、Codex、OpenCode、Cursor 和 Windsurf。将仓库克隆到你的 agent 的 Skill 目录中，agent 会自动检测并使用它来完成 Hermes Agent 部署任务。

### 支持哪些消息平台？

支持 14 个消息平台：Telegram、Discord、Slack、Matrix、Mattermost、WhatsApp、Signal、Email、钉钉、飞书、企业微信、微信、BlueBubbles 和 Webhooks。你可以在一次部署中配置多个平台，Skill 会处理每个平台特定的 Bot 设置要求。

## 贡献

欢迎提 Issue 和 PR。发现缺少平台、环境变量有误或有更好的配置流程，都欢迎贡献。

## 许可证

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hqhq1025](https://github.com/hqhq1025)
- **Source:** [hqhq1025/hermes-setup-skill](https://github.com/hqhq1025/hermes-setup-skill)
- **License:** MIT
- **Homepage:** https://github.com/hqhq1025/hermes-setup-skill

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-hqhq1025-hermes-setup-skill
- Seller: https://agentstack.voostack.com/s/hqhq1025
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.