humanfia/humanize

humanize (hmz) – 面向 AI 驱动编码的代理流程编排器

它是什么

• humanize（以 hmz 调用）是一个命令行工具，可让你将 编码代理（例如 Claude Code、DeepSeek、Kimi，或任何可通过 litellm 访问的模型）作为可配置 流程 的一部分运行。
• 其标语 “面向 token 最大化的代理流程系统” 暗示该工具旨在帮助你串联提示和操作，同时关注 token 使用情况。

主要功能（根据 README 描述）

• 多后端 – 支持 DeepSeek（[dsh]）、Kimi（[kimi]）和通用 litellm 模型。你可以使用额外依赖语法 hmz[all] 安装其中一个、部分或全部。
• CLI 和 Web UI – 在终端中运行 hmz 获取纯文本界面，或启动 hmz web 打开基于浏览器的 UI，显示机器上的每个“epic”（流程）。
• 单行流程执行 – exec 子命令可让你直接从 shell 运行特定流程，例如：

  hmz exec -f chat -a assistant=claude/claude-opus-5:high "这个仓库是做什么的？"
  

• 桌面应用 – 在 macOS 上，你可以下载一个签名的 DMG，它只是将 hmz web UI 包装在原生窗口中。
• 自动更新 – hmz update 拉取最新版本，同时保留你最初安装的额外功能。

安装

1. 先决条件 – Python 3.12+、uv 包管理器，以及受支持的编码代理 CLI（Claude Code、Codex 等）的账户。
2. 安装核心工具：

   uv tool install hmz
   

3. 添加你需要的后端（选择一个、部分或全部）：

   uv tool install 'hmz[all]'   # 安装 DeepSeek、Kimi 和 litellm 支持
   

4. 稍后更新 使用 hmz update 或通过 uvx 运行一次性版本：

   uvx hmz@latest
   uvx --from 'hmz[all]' hmz web
   

基本用法

• hmz – 在当前仓库内启动终端 UI。
• hmz web – 打开 Web UI，显示机器上的所有流程。
• hmz exec … – 直接从命令行运行特定流程（见上面的示例）。

文档与帮助

• 完整文档：https://docs.humanfia.ai/humanize/
• 快速入门指南从 CLI 自动打开。
• macOS 桌面应用指南：https://docs.humanfia.ai/humanize/user/desktop

社区与贡献

• 欢迎提交拉取请求；贡献指南见 CONTRIBUTING.md。
• 错误、功能请求和安全报告有专门的表单和政策。
• 该项目遵循 Apache-2.0 许可证和社区行为准则。

结论 humanize 是一个轻量级编排器，允许开发者接入各种基于 LLM 的编码代理，定义流程，并在终端或浏览器 UI 中运行，重点关注管理 token 消耗。它面向已经使用 AI 编码助手并希望以统一方式串联其操作的开发者。