Hermes 接入 DeepSeek 完整指南:10 分钟配置 DeepSeek API Key,跑通第一句对话
【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent
配完这套参数后,Hermes 会直接调用 DeepSeek 官方接口:你写代码、拆长文档、处理多轮任务,都能丢给它处理。全程只有三个字段需要你亲手填,顺利的话 10 分钟内跑通第一句对话。
动手前确认:Hermes 配置 DeepSeek 的三个前置条件
- ✅ 系统是 Linux、macOS 或 WSL2
- ✅ 已安装 Git(唯一的硬依赖,装 Hermes 时要拉取代码)
- ✅ DeepSeek 开放平台申请好了 API Key(一串密钥字符串,用来证明调用身份)
三条都满足,下面两条命令就能装好 Hermes。
一条命令装好 Hermes 并启动配置向导
在终端粘贴这行安装命令:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash注意:装完先执行source ~/.bashrc或重开一个终端,让 PATH 生效,否则下一步会提示找不到命令。随后启动配置向导:
hermes setup进入交互界面后选 Quick Setup,它会跳过冗长的手动选项,直接带你到模型接入这一环。
配置向导里三个字段怎么填
| 字段 | 填什么 | 填错的后果 |
|---|---|---|
| API Key | 在 DeepSeek 开放平台生成的完整密钥 | 少一个字符就 401 报错,拒绝连接 |
| Base URL | https://api.deepseek.com,一个字符不多 | 多路径或少协议头都会连不上 |
| 模型名 | 先选deepseek-v4-pro | 选错名字会直接报模型不存在 |
三个字段都确认无误,就按提示把向导走完。
敲一次 hermes 验证 Hermes 接入 DeepSeek 是否成功
打开终端,输入hermes回车,进入对话界面后发一句"你好,介绍一下你自己"。
有正常回复、且回复符合 DeepSeek 风格,说明整条链路通了。之后写代码、拆长文档、跑多轮任务,都可以直接丢给它。
Hermes 模型怎么选:deepseek-v4-pro 还是 deepseek-v4-flash
deepseek-v4-pro:处理复杂任务时用,百万级上下文,支持工具调用(Tool Calling,模型自己执行外部操作)和深度思考。deepseek-v4-flash:追求响应速度和更低成本时换这个。
上面这张图就是模型选择界面能看到的信息:DeepSeek V4 Pro标注 1M tokens 上下文,并列出工具调用、深度思考两项能力。
新手不用纠结,默认选deepseek-v4-pro就行,体验过之后随时回向导切换。
连不上时先查这里:Hermes 接入 DeepSeek 的四个高频故障
症状:输入hermes,终端提示"command not found"判断:安装后 shell 没刷新,命令还没进 PATH处理:执行source ~/.bashrc,或直接重开终端再试
症状:连接失败,返回 401 错误判断:API Key 不完整,或平台侧还没生成好密钥处理:回 DeepSeek 开放平台复制完整密钥,粘贴替换旧的
症状:提示地址有误、连不上服务判断:Base URL 多了路径,或漏了https://协议头处理:只填https://api.deepseek.com,一个字符不多
症状:在deepseek-v4-pro和deepseek-v4-flash之间反复犹豫判断:不确定两个模型的分工处理:先跑deepseek-v4-pro,熟悉之后再决定是否换 flash
延伸阅读:Hermes 配置 DeepSeek 的完整文档与仓库
- 完整接入文档:docs/hermes.zh-CN.md
- 英文版:docs/hermes.md
- 全部工具的目录:README.zh-CN.md
- 想离线查所有指南,把仓库拉下来:
git clone https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent三个字段填对,Hermes 接入 DeepSeek 这件事就落位了;下次换别的模型,照同一张表替换就行。
【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考