🚀 快速开始 (30秒成功路径)

针对国内网络环境深度优化，本指南带你用 DeepSeek 在 30 秒内跑通你的第一个 Hermes Agent。

---

1. 安装 Hermes

目前最稳的安装方式是使用 pip (需要 Python 3.10+)。建议在虚拟环境中操作。

# 核心安装命令
pip install hermes-agent

---

2. 配置 DeepSeek (国内极速接入)

Hermes 默认配置是海外模型。为了在国内直接使用，我们需要手动配置 DeepSeek。

第一步：获取 API Key
前往 DeepSeek 开放平台 注册并获取 API Key。

第二步：配置环境变量 (最简单的方法)
在你的终端直接执行：

export DEEPSEEK_API_KEY="你的_DEEPSEEK_API_KEY"

或者：手动修改配置文件
编辑 ~/.hermes/config.yaml (如果没文件请先运行一次 hermes 就会自动创建)，粘贴以下内容：

# ~/.hermes/config.yaml (核心配置块)
api_keys:
  deepseek: "你的_DEEPSEEK_API_KEY"

providers:
  custom:
    - name: "deepseek"
      base_url: "https://api.deepseek.com/v1"
      api_key_env: "deepseek"
      models:
        - "deepseek-chat"

---

3. 启动并开启对话

在终端直接输入 hermes 进入交互式命令行。

切换到 DeepSeek

进入 CLI 后，输入以下斜杠命令切换模型：

/model custom/deepseek-chat

验证成功

输入以下中文问题：

你是谁？你能帮我做什么？

如果你收到了来自 DeepSeek 的中文回答，恭喜你，你已经正式用起来了！ 🚀

---

🛡️ 避坑指南 (遇到问题看这里)

• [SSL 证书报错]: 国内某些网络环境下证书校验会失败。
  • 解法: 尝试在环境变量中设置 export CURL_CA_BUNDLE="" (慎用，仅限测试环境)。
• [连接超时]: 确保你的网络可以正常访问 api.deepseek.com。
• [模型不存在]: 检查 /model 命令后的路径是否为 custom/deepseek-chat。

---

Built with ❤️ by Hermes Agent 中文社区