Bub 0.6.0은 에이전트 커널과 앱을 분리했다

Bub 0.6.0은 0.6 계열의 첫 안정 버전이다. 기본 설치에는 임베드할 수 있는 에이전트 커널 bub.core만 포함하고, CLI·게이트웨이·채널·플러그인 등은 app 추가 기능으로 분리했다. 모델 연결은 Republic을 사용하며, 에이전트 실행 과정을 이벤트로 제공한다.

pip install bub은 커널만 설치한다. CLI와 플러그인 등이 필요한 전체 앱은 다음과 같이 설치해야 한다.

pip install "bub[app]" # full Bub: CLI, gateway, channels, plugins
pip install bub # kernel only, for embedding bub.core.Agent

bub[app] 없이 bub 명령을 실행하면 필요한 패키지와 설치 방법을 안내한다. Docker 이미지와 install.sh, install.ps1, bub install은 이미 전체 앱을 설치하도록 설정돼 있다.

bub.core.Agent는 테이프 저장소를 사용해 에이전트 루프를 실행하고, 실행 시작·종료와 모델·도구 호출 등 각 단계를 EventBus 이벤트로 알린다. Republic의 내장 도구도 지원하며, max_tool_concurrency=로 한 응답에서 동시에 실행할 도구 호출 수를 제한할 수 있다. 시스템 프롬프트와 도구는 실행마다 한 번 준비하고, 프롬프트는 내용이 바뀔 때만 테이프에 기록한다.

플러그인 에이전트 루프 훅은 AgentPlugins를 통해 bub.core.Agent에 연결할 수 있다. 코드 모드도 bub.core.codemode의 재사용 가능한 구성요소가 됐다. 모델 인증·메시지 인코딩·스트리밍은 Republic을 거치며, ChatGPT 요금제 계정으로 접속하려면 codex:<model>과 bub login codex를 사용한다. openai:<model>에는 API 인증 정보가 필요하다. 자세한 내용은 Republic에서 확인할 수 있다.

CLI는 명령 없이 bub를 실행하면 bub chat을 시작하고, bub --version과 플러그인 버전 표시를 지원한다. 릴리스마다 다중 아키텍처 Docker 이미지도 GHCR에 게시된다. 배포 방법은 앱 배포 안내를 참고하면 된다. 문서는 SDK와 앱 안내로 재구성됐으며 bub.build에서 볼 수 있다.

업그레이드할 때 CLI·게이트웨이·채널·플러그인을 사용한다면 pip install -U bub만으로는 의존성이 설치되지 않는다. pip install "bub[app]" 또는 uv add "bub[app]"를 사용해야 한다. bub.tape, bub.tools, bub.store, bub.sidecars는 bub.core.*로 이동했지만 이전 이름도 별칭으로 남아 있다. 반면 코드 모드 내부 모듈 경로에는 호환 별칭이 없다. 도구 등록 방식도 바뀌어 플러그인은 새 provide_tools 훅을 사용해야 한다. 이전 버전과의 세부 변경 사항은 0.6.0 릴리스 노트와 변경 내역에서 확인할 수 있다.