Humanfia, 코딩 에이전트 플로우 실행기 'humanize' 공개

Humanfia 팀이 Python 기반의 에이전트 플로우 실행기 humanize를 공개했다. 이 도구는 Claude Code, Codex 등 코딩 에이전트 CLI를 직접 대체하지 않고, Python으로 작성된 루프(flow)에 따라 CLI에 턴을 맡기며 실행을 기록하는 런타임 역할을 한다.

아키텍처 및 백엔드 지원

• 4층 구조: Flows(작업 정의) -> humanize(실행/기록) -> Coding agents(모델 호출 CLI) -> Environment(작업 위치)로 구성된다.
• 백엔드: claude, codex, kimi, pi, dsh, agy, grok, mimo, mcode, opencode, qwen, cursor-agent 등 12종을 지원한다. ACP 구현 CLI도 추가 가능하다.
• 설치: Python 3.12 이상 필요하며, GitHub 저장소에서 설치해야 한다. PyPI의 hmz나 humanize 패키지와는 무관하다.

플로우 및 예산 관리

• 공식 플로우 14종: chat만 내장되어 있으며, 나머지는 humanfia/flowverse 저장소에서 다운로드한다. 반복형(ralph_loop), 교대형(flame_chase), 작업자-검토자(rlar) 등 다양한 패턴을 제공한다.
• 예산 모델: chat을 제외한 모든 플로우에 필수다. duration(시간), cost(비용), output_tokens(출력 토큰) 중 하나 이상 소진 시 종료된다.
• 권한 모델: 실행 중 승인 없이 선언된 범위(local, user, system, online) 내에서만 동작한다. Linux Landlock과 macOS Seatbelt을 통해 강제 격리한다.

성능 및 보안

• 성능 측정: Humanfia 자체 실험에서 Opus-4.8 구현과 GPT-5.5 검토 루프를 결합했을 때 ProgramBench에서 **3.5%**의 해결률을 기록했다. 이는 단독 모델 성능(0~0.5%) 대비 상승한 수치다.
• 보안: humanize는 Apache-2.0 라이선스지만, flowverse 저장소는 라이선스가 없다. 모든 에이전트는 승인 없이 파일 수정 및 명령을 실행하므로 실험용 저장소 사용이 권장된다.