保姆级教程!零基础搭建本地AI助手

你是不是也想拥有一个属于自己的本地 AI 助手？今天手把手教你搭建 Hermes Agent，适合零基础新手！

📋 什么是 Hermes Agent？

Hermes Agent 是一个开源的本地 AI 助手框架，支持多平台接入，可以帮你完成各种任务：

• 🔍 网络搜索与信息查询
• ✍️ 写作文章、摘要、翻译
• 🖼️ AI 画图（支持 Midjourney、DALL-E、MiniMax 等）
• 🎵 音乐与语音合成
• 📱 发飞书、发微信、发邮件
• 💻 编程与代码调试
• 🌐 多语言翻译

🛠️ 环境准备

开始之前，确保你的电脑安装了以下环境：

• Python 3.10+
  
   — 官网下载
• Git
  
   — 官网下载
• API Key
  
   — 你常用的 AI 模型密钥（如 OpenAI、Claude、MiniMax 等）

🚀 一步步安装

第一步：克隆项目代码

git clone https://github.com/nousresearch/hermes-agent cd hermes-agent

第二步：安装依赖

pip install -r requirements.txt

第三步：配置 API Key

cp config.example.yaml config.yaml # 用文本编辑器打开 config.yaml，填入你的 API Key

第四步：启动运行

python main.py

⚙️ 配置文件说明

config.yaml 主要配置项：

# 模型提供商：openai / anthropic / minimax / google 等 model_provider: openai  # 你的 API Key api_key: sk-your-api-key-here  # 启用的技能模块 skills:   - search       # 搜索   - write        # 写作   - image        # 画图   - tts          # 语音合成   - code         # 编程   - social       # 社交媒体

✨ 基础使用方法

启动成功后，你可以通过以下方式和 Hermes Agent 交互：

1. 命令行对话

# 在终端直接输入问题 python main.py "帮我写一封道歉邮件"

2. 技能调用

# 画图 python main.py --skill image "一只橘猫在喝咖啡"  # 语音合成 python main.py --skill tts "今天天气真好"  # 搜索信息 python main.py --skill search "今天发生了什么新闻"

3. 对话模式（交互式）

python main.py --interactive # 然后直接输入你想问的问题

🔧 常见问题

Q：运行报 “Module not found” 错误？

A：运行 pip install -r requirements.txt 重新安装依赖。

Q：API Key 从哪里获取？

A：不同模型不同渠道 — OpenAI 去官网购买，MiniMax 可以用国内的 API 平台。

Q：响应很慢怎么办？

A：检查网络连接，或换用国内模型（如 MiniMax）加速。

📚 项目地址

• 🌐 GitHub：https://github.com/nousresearch/hermes-agent
• 📖 文档：https://docs.hermes-agent.dev

💬 总结

搭建本地 AI 助手其实并不复杂，按照上面的步骤，十分钟就能跑起来。一旦配置好，你就有了一个属于自己的 AI 助手，可以帮你处理各种日常任务！

快去试试吧，有问题欢迎留言交流 🚀