Kohaku-Lab/KohakuTerrarium

해결하는 문제

많은 기존 에이전트 제품(예: Claude Code, Codex 등)은 각각 동일한 기본 메커니즘(컨트롤러 루프, 도구 디스패치, 트리거, 하위 에이전트, 세션, 지속성 및 다중 에이전트 연결)을 다시 구현합니다. KohakuTerrarium은 이 공유 기반을 한 곳에 두므로 새 에이전트 형태를 만드는 것이 전체 새 코드베이스가 아닌 구성 파일과 몇 가지 사용자 지정 모듈이 됩니다.

작동 방식

KohakuTerrarium은 Python 프레임워크입니다. 핵심 추상화는 "크리처"입니다. 자체 컨트롤러(추론 루프), 도구, 트리거, 하위 에이전트, 메모리 및 입력/출력을 갖춘 독립 에이전트입니다. 크리처는 크리처 그래프, 채널, 수명 주기 및 세션 관리를 관리하는 "Terrarium" 엔진에 의해 호스팅됩니다. 그 위에 "Studio" 레이어가 관리, ID 및 사용자 대면 표면(웹 대시보드, 데스크톱 앱, HTTP API)을 처리합니다. 선택적으로 "Laboratory" 레이어는 WebSocket을 통해 호스트와 엔진을 여러 머신으로 분할합니다. 에이전트는 유형화된 결과를 가진 비동기 Python 객체이므로 자체 프로그램에 직접 포함할 수 있습니다. CLI, TUI, 웹 또는 데스크톱을 통해 에이전트를 실행하고 >>(시퀀스), &(병렬), |(폴백) 및 *(재시도)와 같은 연산자를 사용하여 파이프라인으로 구성할 수 있습니다.

대상 사용자

이것은 바퀴를 재발명하지 않고 사용자 지정 AI 에이전트를 구축하려는 개발자를 위한 것입니다. 단일 에이전트, 다중 에이전트 팀 또는 배치 작업, 봇 또는 파이프라인과 같은 더 큰 Python 애플리케이션에 포함된 에이전트가 필요한 경우 모두 해당됩니다. 또한 사용자 지정할 수 있는 강력한 즉시 사용 가능한 에이전트를 원하는 사람들을 위한 것입니다. 이미 요구 사항에 맞는 안정적인 에이전트 제품이 있거나 작업당 50ms 미만의 대기 시간이 필요한 경우 적합하지 않을 수 있습니다.

하이라이트

• 에이전트 수준 추상화: 런타임을 다시 구축하지 않고 구성 및 사용자 지정 모듈을 작성하여 새 에이전트를 정의합니다.
• 실제 Python API: 실제로 취소되는 시간 초과가 있는 유형화된 TurnResult 턴, 스트리밍 유형화된 이벤트, 모든 함수를 에이전트 도구로 변환하는 @kt.tool, 엄격한 오류 처리.
• 내장 세션 지속성 및 재개: 세션이 자동으로 저장됩니다. 나중에 kt resume 또는 Terrarium.resume으로 재개합니다. SessionReader는 완료된 실행을 오프라인으로 재생합니다.
• 검색 가능한 세션 기록: 모든 이벤트가 인덱싱됩니다. kt search 및 search_memory 도구를 사용하면 사용자(및 에이전트)가 과거 작업을 조회할 수 있습니다.
• 비차단 컨텍스트 압축: 오래 실행되는 에이전트는 백그라운드에서 컨텍스트가 압축되는 동안 계속 작동합니다.
• 포괄적인 내장 도구 및 하위 에이전트: 파일, 셸, 웹, JSON, 노트북, 검색, 편집 및 권한 있는 노드용 그래프 편집기 도구.
• 컨텍스트 인식 사이드 대화: 선택적 fork 도우미를 사용하면 기본 작업에 영향을 주지 않고 격리된 스냅샷에서 사이드 질문을 할 수 있습니다.
• MCP 지원: 에이전트별 또는 전역적으로 MCP 서버(stdio 또는 streamable-HTTP)에 연결합니다. 4개의 메타 도구는 서버가 많아도 프롬프트를 작게 유지합니다.
• 패키지 시스템 및 마켓플레이스: kt install @name은 TerrariumMarket을 통해 해석됩니다. 멱등성 스크립트 측 기본 요소를 사용할 수 있습니다.
• 구성 대수: >>, &, |, * 및 .iterate 연산자를 사용하여 에이전트 파이프라인을 구축합니다.
• 여러 런타임 표면: CLI, TUI, 웹 대시보드 및 기본 데스크톱 앱이 기본 포함됩니다.
• 선택적 4계층 인증(호스트 토큰, 관리자 암호, 다중 사용자 계정) — 레이어별로 선택, 기본적으로 꺼짐.