CodeSoul-co/Hypha

What it solves

Hypha는 관리되고, 내구성이 있으며, 재사용 가능한 도메인 특화 AI 에이전트를 구축하기 위한 프로덕션 준비 완료된 프레임워크를 제공합니다. Hypha는 핵심 추론 로직을 실행 하네스(execution harness)와 분리함으로써 에이전트의 동작이 제한되고, 감사 가능하며, 복구 가능하도록 보장하여, 단순한 프로토타입에서 프로덕션으로 에이전트를 전환하는 문제를 해결합니다.

How it works

Hypha는 추론, 계획 및 도구 선택을 위한 Agent Core와, 내장된 정책 및 승인 게이트를 갖춘 유한 상태 머신(Finite State Machine, FSM)을 통해 실제 실행을 관리하는 Production Harness로 구성된 2계층 아키텍처를 사용합니다.

제품별 로직은 하드코딩되지 않고 대신 DomainPack—태스크, 워크플로우, 프롬프트 및 기능을 공유 런타임으로 컴파일하는 구성—에 정의됩니다. 성능과 비용을 최적화하기 위해, Cache & Reuse Plane은 캐시가 신뢰할 수 있는 원천(source-of-truth) 이벤트 로그를 덮어쓰지 않도록 하면서 여러 계층의 캐시된 데이터(추론 서브그래프 및 도구 결과 등)를 관리합니다.

Who it’s for

금융, 법률 또는 연구와 같이 신뢰성, 감사 가능성 및 도구 실행의 엄격한 거버넌스가 요구되는 산업 분야를 위한 전문화된 에이전트를 구축하는 개발자를 위해 설계되었습니다.

Highlights

• DomainPack System: 제품별 동작을 런타임에서 분리하여 하나의 프레임워크가 여러 다른 에이전트 유형을 지원할 수 있도록 합니다.
• Event-First Runtime: 이벤트 기반 실행 모델을 사용하여 에이전트 동작의 복구, 재생 및 전체 감사를 가능하게 합니다.
• Multi-Layered Caching: 검증된 작업을 재사용하고 LLM 비용과 지연 시간을 줄이기 위해 특화된 캐시 트리(예: PlanTree, ToolTree)를를 구현합니다.
• Governed Capabilities: 정책 및 승인 제어를 갖춘 관리된 호출 경로를 통해 도구 및 MCP (Model Context Protocol) 어댑터를 통합합니다.
• Durable Execution: 체크포인트, 제한된 컨티뉴에이션(bounded continuation) 및 복구 워커를 지원하여 장기 실행 태스크가 손실되지 않도록 보장합니다.