humanfia/humanize

humanize (hmz) – AI 기반 코딩을 위한 에이전트 플로우 오케스트레이터

이것이 무엇인가

humanize(명령어: hmz)는 코딩 에이전트(예: Claude Code, DeepSeek, Kimi, 또는 litellm을 통해 접근 가능한 모든 모델)를 구성 가능한 플로우의 일부로 실행할 수 있게 해주는 명령줄 도구입니다.
태그라인인 *"토큰 극대화를 위한 에이전트 플로우 시스템"*은 이 도구가 토큰 사용량을 주시하면서 프롬프트와 작업을 연결하는 데 도움을 주기 위한 것임을 암시합니다.

주요 기능(README에 설명된 대로)

다중 백엔드 – DeepSeek([dsh]), Kimi([kimi]), 그리고 일반적인 litellm 모델 지원. 추가 의존성 구문 hmz[all]을 사용하여 하나, 일부 또는 모두를 설치할 수 있습니다.
CLI 및 웹 UI – 터미널에서 hmz를 실행하여 텍스트 전용 인터페이스를 사용하거나, hmz web을 실행하여 머신의 모든 "에픽"(플로우)을 보여주는 브라우저 기반 UI를 엽니다.
한 줄 플로우 실행 – exec 하위 명령을 사용하여 셸에서 직접 특정 플로우를 실행할 수 있습니다. 예:
```
hmz exec -f chat -a assistant=claude/claude-opus-5:high "이 저장소는 무엇을 하나요?"
```
데스크톱 앱 – macOS에서는 hmz web UI를 네이티브 창으로 감싼 서명된 DMG를 다운로드할 수 있습니다.
자동 업데이트 – hmz update는 원래 설치한 추가 기능을 보존하면서 최신 릴리스를 가져옵니다.

설치

사전 요구 사항 – Python 3.12+, uv 패키지 관리자, 그리고 지원되는 코딩 에이전트 CLI(Claude Code, Codex 등) 계정.
핵심 도구 설치:
```
uv tool install hmz
```

필요한 백엔드 추가(하나, 일부 또는 모두 선택):

uv tool install 'hmz[all]'   # DeepSeek, Kimi, litellm 지원 설치

나중에 업데이트는 hmz update로 하거나 uvx를 통해 일회성 버전 실행:
```
uvx hmz@latest
uvx --from 'hmz[all]' hmz web
```

기본 사용법

hmz – 현재 저장소 내에서 터미널 UI를 시작합니다.
hmz 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 코딩 어시스턴트를 사용하고 있으며 작업을 연결하는 통합된 방법을 원하는 개발자를 대상으로 합니다.

humanfia/humanize

humanize (hmz) – AI 기반 코딩을 위한 에이전트 플로우 오케스트레이터

관련