본문으로 건너뛰기

트렌딩 - GitHub 인기 레포 & HuggingFace 모델

raroque/boop-agent

TypeScript2 / 0

iMessage를 인터페이스로 사용하고 Sendblue, Composio, Convex를 연계하여 서브에이전트·메모리·자동화·디버깅 대시보드를 제공하는 개인 에이전트 템플릿이다.

TL;DR

Boop은 iMessage를 프론트엔드로 삼아 Claude Code 또는 Codex 런타임을 로컬 세션으로 재사용하고 Sendblue를 통해 메시지를 송수신하며 Convex에 메모리와 로그를 저장하는 개인 에이전트 템플릿이다. 핵심 구조는 간단한 디스패처가 요청을 판별하고 필요한 통합만 로드하는 실행 에이전트를 스폰하는 방식이며 Composio를 통해 수백 개 툴킷을 계정 별로 안전하게 연결할 수 있다. 디버그 대시보드와 자동 웹후크 등록, 메모리의 일간 정리 파이프라인이 포함되어 빠른 로컬 프로토타이핑과 운영이 가능하지만 README가 명시하듯 비용·보안 최적화는 별도 검토가 필요하다.

핵심 포인트

  • 런타임 선택에서 Claude Code 구독 또는 Codex/ChatGPT 구독의 로컬 세션 인증을 활용하여 별도의 Anthropic/OpenAI API 키 없이 에이전트를 실행할 수 있다. 이 접근은 사용자가 자신의 구독 자격 증명을 로컬에서 재사용하도록 설계되어 별도 API 키 관리를 줄인다. 결과적으로 개인 단위의 운영에서 간편한 인증 경로를 제공한다.
  • Sendblue CLI와 ngrok 자동 동기화를 통해 퍼블릭 터널 URL이 바뀔 때마다 인바운드 웹후크를 자동으로 등록하고 서명 비밀을 동기화한다. 이 자동 등록 기능은 무료 ngrok의 가변 URL 환경에 맞춰 개발자의 반복적인 대시보드 설정 작업을 제거한다. 수동으로 구성하려는 경우 관련 npm 스크립트로 확인·동기화 작업을 수행할 수 있다.
  • 메모리 정리 작업을 3단계 적대적 파이프라인(제안자 → 적수 → 판정자)으로 설계하여 중복 병합, 모순 해결, 잡음 제거를 자동화한다. 이 파이프라인은 매일 기본 스케줄로 실행되며 수동으로도 트리거할 수 있어 장기 메모리 유지 관리 부담을 줄인다. 구현상 각 단계는 구성된 런타임과 모델 기본값을 사용하도록 설계되었다.
  • iMessage 입·출력을 Sendblue 웹후크와 연동하여 처리하며 서명된 인바운드 요청과 타이핑 인디케이터, 웹후크 중복 방지 기능을 포함한다. Sendblue CLI 통합으로 로컬 개발 시 ngrok와 연동된 웹후크를 자동으로 등록하거나 갱신할 수 있다. 이로 인해 개발자가 매번 대시보드에 URL을 붙여넣을 필요 없이 로컬에서 대화를 주고받을 수 있다.

이미지 분석

iMessage 대화창에서 Boop이 자동으로 답변하고 디버그 대시보드에서 상태를 확인하는 흐름을 캡처한 스크린샷이다.
이미지는 사용자가 iMessage로 질문을 보낸 뒤 Boop이 등록된 자동화와 메모리를 참조해 응답하는 실제 대화 흐름을 캡처하고 있다. 상단에는 디버그 대시보드 연동을 암시하는 배너와 프로필이 보이며, 중간에는 iMessage의 푸시 응답과 Delivered 상태가 표시되어 Sendblue를 통한 송수신 경로가 실제로 동작함이 확인된다. 이 스크린샷은 Boop이 외부 웹훅과 로컬 런타임을 통해 실사용 메시징 루프를 완성하는 방식을 시각적으로 보여준다.
디버그 대시보드의 Agents 탭으로, 스폰된 실행 에이전트들의 타임라인과 사용량·토큰·상태 정보가 나열된 화면이다.
이미지는 대시보드에서 각 실행 에이전트의 상태(완료·실패), 사용된 토큰 수, 실행 시간 등 운영 지표를 한눈에 확인할 수 있음을 보여준다. 화면 하단과 각 카드에는 어떤 통합을 건드렸는지 로고가 표시되어 스폰 호출 시 어떤 툴킷이 사용되었는지를 추적할 수 있다. 이 뷰는 실사용 중 에이전트의 비용·성능·통합 범위를 모니터링하는 운영 도구 역할을 명확히 전달한다.
디버그 대시보드의 Automations 탭으로, 예약된 반복 작업과 그 상태를 보여주는 화면이다.
이미지는 사용자가 자연어로 정의한 반복 작업이 스케줄로 등록되어 정기적으로 실행되는 과정을 보여주며 각 자동화 항목의 실행 주기와 마지막 실행 시간 정보를 제공한다. 이 화면은 Automations가 텍스트 명령을 해석해 스폰 에이전트를 예약하고 결과를 다시 iMessage로 전달하는 플로우의 운영 지점을 시각화한다. UI 상에서 자동화 토글과 스케줄 정보를 통해 자동화의 활성화·비활성화 상태를 제어할 수 있음이 확인된다.

1k

STARS

239

FORKS

+212

TRENDING

2

조회수

watchers 1kopen issues 16MIT License

관련 토론

아직 관련 토론이 없습니다.

댓글

댓글을 작성하려면 로그인이 필요합니다.