Flowix

Hermes 配置

Hermes 是社区维护的开源 AI Agent CLI(hermes-cli),完全免费、无云依赖。它本身不带模型,而是作为一个本地 Agent 调度器,去对接 Ollama / LM Studio / vLLM 任意 OpenAI 兼容服务。

Flowix Memo 把 Hermes 当作一个外挂 Agent -- 接好本地模型后端后,你在文档光标位置就能直接调用本地模型,不用切换终端,不用复制上下文,也不用手动管理历史对话。Hermes 跟 Claude Code / Codex 是互补关系-- 能力略弱、速度看硬件,但胜在数据不出本地、不烧钱,适合公司禁止数据出境、断网环境、想零成本跑模型的场景。同一个文档可以同时放多张 Hermes 卡片,每张独立跑自己的对话流。

1. 安装 Hermes

前提条件:

  • 您需要安装 Python 3.10 或更新版本
  • macOS 用户推荐使用 Homebrew(brew install python)或 pyenv。不推荐直接安装包安装(后续可能会遇到 pip 权限问题)
  • Windows 用户还需安装 Git for Windows
  • 跑本地模型需要足够内存:7B 模型 8GB+,32B 模型 32GB+

进入命令行界面,安装 Hermes:

pip install hermes-cli

升级到最新版本:

pip install --upgrade hermes-cli

注意:macOS 用户若在安装过程中遇到 pip 权限问题,请使用 Homebrew / pyenv 方式装 Python。安装成功后,还需下方「二、如何在 Flowix Memo 使用 Hermes」完成接入,先不要直接使用 hermes 命令启动(本地还没起模型后端时不会响应)。

1.1 macOS

第一步:安装 Python 3.10+

brew install python

第二步:全局装 Hermes CLI

pip install hermes-cli
  1. 验证安装:hermes --version,输出版本号说明 CLI OK
  2. 升级(可选):pip install --upgrade hermes-cli
  3. 全链路验证:在终端跑 hermes --help 能输出版本与帮助说明 CLI OK;真正的"hello"验证要等 1.2 节起好本地模型后端再跑。

1.2 windows 11

  1. 装 Python 3.10+:到 python.org 装 LTS 版本,安装时勾选 Add to PATH
  2. 装 Git for Windows
  3. 全局装 CLI:用 管理员 PowerShell 执行 pip install hermes-cli
  4. 验证安装:hermes --version,输出版本号说明 CLI OK
  5. 升级(可选):pip install --upgrade hermes-cli
  6. 全链路验证:新开一个终端 跑 hermes --help,跑通说明 CLI + PATH 都通了;真正的"hello"验证要等下方「二」起好本地模型后端再跑。

2. 如何在 Flowix Memo 使用 Hermes

CLI 装好之后,Flowix Memo 自动检测识别,但 Hermes 不内置模型,所以多一步:先启动一个本地模型后端,再让 Flowix 知道后端地址。

启动本地模型后端(任选其一):

  • Ollama(最简单,零配置)-- ollama serve(默认 http://localhost:11434/v1),再 ollama pull qwen2.5-coder:7b 拉一个模型
  • LM Studio -- 加载 GGUF 模型,在 Developer 面板启动 OpenAI Compatible Server(默认 http://localhost:1234/v1)
  • vLLM(生产级)-- vllm serve Qwen/Qwen2.5-Coder-32B-Instruct --port 8000

后端起来后,在 Flowix 设置 > AI > Hermes 里填:

字段 示例值
Base URL http://localhost:11434/v1(Ollama 默认)
Model qwen2.5-coder:7b
API key ollama(Ollama 不验证,填任意)
Context size 8192

保存后 Flowix 会 ping 一下 /v1/models 验证可达,可达就会提示绿色对勾。

2.1 通过命令插入 Agent 卡片

在文档任意位置输入 / 弹出 Agent 类型菜单,选 Hermes,系统会插入一张可拖拽的 Agent 卡片。

2.2 AI Agent 对话

文档光标位置就能直接调用本地模型,不用切换终端,不用复制上下文,也不用手动管理历史对话。响应速度取决于本地硬件 -- 7B 模型 8GB 内存够用、轻量任务快;长文写作 / 多文件重构建议放到 32B+ 或直接换 Claude Code。