Kohaku-Lab/KohakuTerrarium

해결하는 문제

KohakuTerrarium은 개발자가 새로운 AI 에이전트를 만들 때마다 동일한 기본 인프라("서브스트레이트")를 반복해서 재구성하는 사이클을 중단하기 위해 설계된 프레임워크입니다. 에이전트 로직, 도구 디스패치, 세션 지속성, 다중 에이전트 오케스트레이션을 위한 표준화되고 재사용 가능한 기반을 제공하며, 사용자가 구성 파일과 사용자 정의 모듈을 통해 새로운 에이전트 "형태"를 정의할 수 있도록 합니다. 이는 런타임을 다시 구현할 필요 없이 가능하게 합니다.

작동 방식

이 프레임워크의 핵심은 creature(크리처)이며, 추론 루프(Controller), Input, Output, Tools, Triggers, Sub-agents의 6개 모듈로 구성된 독립형 에이전트입니다. 이러한 크리처들은 Terrarium 엔진에 의해 호스팅되며, 그래프 토폴로지, 통신 채널, 세션 기록을 관리합니다. Studio 계층은 웹 대시보드와 데스크톱 앱과 같은 관리 인터페이스를 제공하며, 선택적인 Laboratory 전송 계층을 통해 WebSockets를 통해 엔진을 여러 머신에 분산할 수 있습니다.

대상 사용자

사용자 정의 가능한 에이전트 아키텍처가 필요한 개발자, Python을 통해 배치 작업이나 파이프라인을 프로그래밍적으로 제어하고 싶은 개발자, 또는 하나의 기존 에이전트 제품에 맞지 않는 진화하는 에이전트 요구사항을 구축하는 개발자에게 적합합니다.

주요 특징

• 에이전트 수준의 추상화: 런타임을 다시 구현하지 않고 구성 파일과 사용자 정의 모듈을 사용해 새로운 에이전트를 정의할 수 있습니다.
• 코드 기반 조합 대수: >>(시퀀스), &(병렬), |(백업)와 같은 연산자를 사용해 에이전트를 복잡한 파이프라인으로 연결할 수 있습니다.
• 내장 지속성: 네이티브 세션 관리 기능을 통해 kt resume 명령어로 수 시간 후에도 에이전트를 재개할 수 있습니다.
• MCP 지원: 에이전트별 또는 전역적으로 Model Context Protocol (MCP) 서버에 연결할 수 있습니다.
• 패키지 시스템: 미리 빌드된 크리처와 플러그인을 공유하고 설치할 수 있는 전용 마켓플레이스(kt install @name)가 있습니다.
• 다중 인터페이스: CLI, TUI, 웹 대시보드, 네이티브 데스크톱 애플리케이션을 기본 제공합니다.