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 webUI をネイティブウィンドウにラップした署名済み DMG をダウンロードできます。 - 自動更新 –
hmz updateは、最初にインストールした追加機能を保持しながら最新リリースを取得します。
インストール
- 前提条件 – Python 3.12+、
uvパッケージマネージャー、およびサポートされているコーディングエージェント CLI(Claude Code、Codex など)のアカウント。 - コアツールをインストール:
uv tool install hmz - 必要なバックエンドを追加(1 つ、一部、またはすべてを選択):
uv tool install 'hmz[all]' # DeepSeek、Kimi、litellm サポートをインストール - 後で更新 するには
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 で実行できる軽量オーケストレーターであり、トークン消費の管理に重点を置いています。AI コーディングアシスタントをすでに使用しており、アクションを統一的に連鎖させたい開発者向けに位置付けられています。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト