# hermes

**Repository Path**: ckorig/hermes

## Basic Information

- **Project Name**: hermes
- **Description**: 黑妹应用
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hermes

## 介绍

黑妹实战

### Hermes Setup

```
sudo apt install unzip python3-pip python3-venv -y

rm -rf ~/.hermes/hermes-agent
wget -O hermes-agent.zip https://ghproxy.com/https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip

unzip hermes-agent-main.zip -d ~/.hermes/
mv ~/.hermes/hermes-agent-main ~/.hermes/hermes-agent

cd ~/.hermes/hermes-agent
source venv/bin/activate

# 尝试运行 hermes_cli 模块
python -m hermes_cli --version

# 或者直接运行 main.py
python hermes_cli/main.py --version

# 或者查看是否有 __main__.py
python -m hermes_cli.main --version

# 查看是否有 __main__.py
cat ~/.hermes/hermes-agent/hermes_cli/__main__.py 2>/dev/null || echo "没有 __main__.py"

# 查看 main.py 内容（前几行）
head -20 ~/.hermes/hermes-agent/hermes_cli/main.py

cat > ~/.local/bin/hermes << 'EOF'
#!/bin/bash
cd ~/.hermes/hermes-agent
source venv/bin/activate
python -m hermes_cli "$@"
EOF

chmod +x ~/.local/bin/hermes

# 测试
hermes --version

# 直接运行 main.py
python hermes_cli/main.py --version
如果上面的命令成功显示版本号，就创建启动脚本：

cat > ~/.local/bin/hermes << 'EOF'
#!/bin/bash
cd ~/.hermes/hermes-agent
source venv/bin/activate
python hermes_cli/main.py "$@"
EOF

chmod +x ~/.local/bin/hermes

# 测试
hermes --version
```

### Hermes+阿里百炼

```
推荐方案：使用 Hermes 命令行配置（最稳妥）

打开终端 CMD，直接执行以下命令。这会覆盖掉可能冲突的环境变量，直接写入 Hermes 的配置文件。

第一步：配置模型接入

请依次执行以下命令（记得把 你的API_Key 替换成真实的）：

1. 设置 Provider 为自定义模式
hermes config set model.provider custom

2. 设置百炼的 OpenAI 兼容地址 (注意路径是 /compatible-mode/v1)
hermes config set model.base_url https://dashscope.aliyuncs.com/compatible-mode/v1

3. 设置 API Key (直接使用截图中的 sk-7abd17... 这个 Key)
hermes config set model.api_key sk-7abd17af825a4fce9f2bf******

4. 设置默认模型 (建议使用 qwen3.6-plus，也可以试试截图里的 flash 版)
hermes config set model.default qwen3.6-plus

第二步：验证与重启

检查配置是否生效，确保显示 "connected"
hermes doctor

第三步：启动测试
hermes -z "自我介绍"
```

### Hermes+Himalaya

📧 Himalaya 邮件命令行客户端

Himalaya 是一个命令行邮件客户端，允许你通过终端使用 IMAP、SMTP、Notmuch 或 Sendmail 后端来管理电子邮件。
📚 参考资料

```
    配置文件设置 + IMAP/SMTP 认证
    消息撰写指南 (用于撰写邮件的 MML 语法)
```

🛠️ 前置准备

```
    已安装 Himalaya CLI (himalaya --version 用于验证)
    在 ~/.config/himalaya/config.toml 处有一个配置文件
    已配置 IMAP/SMTP 凭据（密码需安全存储）
```

📥 安装

```
安装 Himalaya：
   预编译二进制文件 (Linux/macOS — 推荐)
   curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | PREFIX=~/.local sh
```


⚙️ 配置设置

运行交互式向导来设置账户： himalaya account configure

或者手动创建 ~/.config/himalaya/config.toml 文件：

```
iris@IRS-SZ-V4-97:~/.config/himalaya$ cat config.toml
[accounts.personal]
email = "kechen@irissz.com"
display-name = "Kechen"
default = true

backend.type = "imap"
backend.host = "imap.exmail.qq.com"
backend.port = 993
backend.encryption.type = "tls"
backend.login = "kechen@irissz.com"
backend.auth.type = "password"
backend.auth.raw = "***44**81***"

message.send.backend.type = "smtp"
message.send.backend.host = "smtp.exmail.qq.com"
message.send.backend.port = 465
message.send.backend.encryption.type = "tls"
message.send.backend.login = "kechen@irissz.com"
message.send.backend.auth.type = "password"
message.send.backend.auth.raw = "***44**81***"
```

📝 常用操作

```
列出文件夹 himalaya folder list 

列出邮件
    - 列出收件箱 (默认) 中的邮件：himalaya envelope list
    - 列出特定文件夹中的邮件：himalaya envelope list --folder "Sent"
    - 分页列出 (第1页，每页20条)：himalaya envelope list --page 1 --page-size 20

搜索邮件 himalaya envelope list from john@example.com subject meeting
```

### Hermes+UI

![输入图片说明](heimei.png)

### Hermes+weixin

![输入图片说明](wexin.png)

### Hermes+wechat

![输入图片说明](wechat.png)