humanfia/humanize

The agent flow system for token maxxing.

humanize (hmz) – AI を活用したコーディングのためのエージェントフローオーケストレーター

概要

  • humanize(hmz として呼び出し)は、設定可能な フロー の一部として コーディングエージェント(例:Claude Code、DeepSeek、Kimi、または litellm 経由でアクセス可能な任意のモデル)を実行できるコマンドラインツールです。
  • そのキャッチコピー 「トークン最大化のためのエージェントフローシステム」 は、このツールがプロンプトとアクションを連鎖させながら、トークン使用量に注意を払うことを目的としていることを示唆しています。

主な機能(README の説明による)

  • 複数バックエンド – DeepSeek([dsh])、Kimi([kimi])、および汎用の litellm モデルをサポート。追加依存関係の構文 hmz[all] を使用して、1 つ、一部、またはすべてをインストールできます。
  • CLI と Web UI – ターミナルで hmz を実行してテキストのみのインターフェースを使用するか、hmz web を起動して、マシン上のすべての「エピック」(フロー)を表示するブラウザベースの UI を開きます。
  • ワンライナーでのフロー実行 – exec サブコマンドを使用すると、シェルから特定のフローを直接実行できます。例:
    hmz exec -f chat -a assistant=claude/claude-opus-5:high "このリポジトリは何をしますか?"
    
  • デスクトップアプリ – macOS では、hmz web UI をネイティブウィンドウにラップした署名済み DMG をダウンロードできます。
  • 自動更新 – hmz update は、最初にインストールした追加機能を保持しながら最新リリースを取得します。

インストール

  1. 前提条件 – Python 3.12+、uv パッケージマネージャー、およびサポートされているコーディングエージェント CLI(Claude Code、Codex など)のアカウント。
  2. コアツールをインストール:
    uv tool install hmz
    
  3. 必要なバックエンドを追加(1 つ、一部、またはすべてを選択):
    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 … – コマンドラインから特定のフローを直接実行します(上記の例を参照)。

ドキュメントとヘルプ

コミュニティと貢献

  • プルリクエストは歓迎します。貢献ガイドラインは CONTRIBUTING.md にあります。
  • バグ、機能リクエスト、セキュリティレポートには専用のフォームとポリシーがあります。
  • このプロジェクトは Apache-2.0 ライセンスとコミュニティ行動規範に従います。

結論 humanize は、開発者がさまざまな LLM ベースのコーディングエージェントをプラグインし、フローを定義して、ターミナルまたはブラウザ UI で実行できる軽量オーケストレーターであり、トークン消費の管理に重点を置いています。AI コーディングアシスタントをすでに使用しており、アクションを統一的に連鎖させたい開発者向けに位置付けられています。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト