Repolode
제출하기
robbin

robbin/grokbot-local-agent

Grok Bot이 무거운 코딩·글쓰기 작업을 같은 머신의 로컬 Pi 에이전트에 맡기고, 완료되면 웹훅으로 알림을 받을 수 있게 해주는 스크립트입니다.

GitHub에서 보기
스타
86
포크
11
열린 이슈
0
마지막 커밋
12일 전

어떤 프로젝트인가요?

grokbot-local-agent는 같은 Linux 머신에서 Grok Bot이 로컬 코딩 에이전트인 Pi에 작업을 맡길 수 있게 해주는 스크립트 모음입니다. 여러 파일을 일괄 수정하거나 간단한 스크립트를 작성하고, 긴 초안이나 리서치 자료를 만드는 등의 무거운 작업을 사용자가 보유한 모델 계정으로 Pi에서 실행하므로 Bot의 구독 사용량을 소모하지 않습니다.

위임된 각 호출은 추적 가능한 작업으로 감싸져 ~/.pi/tasks/<ID>/ 아래에 상태와 산출물이 저장됩니다. 작업이 완료되면 웹훅에는 ID, 소유자, 상태, 종료 코드만 전달되고, 이를 통해 Bot이 깨어나 파일을 읽고 결과를 확인한 뒤 보고하고 작업을 확인 처리합니다. 소유자 기준으로 필터링되는 pending, list, ack 명령은 여러 Bot이 서로의 작업을 보고하지 않도록 하며, pending을 사용하면 알림을 놓친 경우에도 Bot이 결과를 확인할 수 있습니다.

이 프로젝트는 격리된 샌드박스 서비스가 아니라 Bot이 사용하는 머신에서 동작하는 가벼운 보조 도구입니다. Node 22+가 필요하며 클라이언트 스크립트에는 서드파티 의존성이 없습니다.

핵심 기능

  • 01같은 머신에서 Pi 코딩 에이전트를 통해 위임된 작업을 실행합니다.
  • 02각 작업의 ID, 상태, 산출물을 디스크에 기록해 추적합니다.
  • 03완료 시 웹훅을 보내 Bot이 결과를 확인하고 보고할 수 있게 합니다.
  • 04소유자 에이전트 ID를 기준으로 pending, list, ack를 필터링해 Bot 간 결과가 뒤섞이지 않게 합니다.
  • 05후속 대화, 취소, 고정 모델을 사용하는 동기식 단축 실행을 지원합니다.
  • 06선택 사항인 Telegram 모니터로 Pi 세션 진행 상황을 비공개 채팅에 전송합니다.

활용 사례

  • 구독 사용량이 제한된 채팅 봇의 파일 일괄 수정이나 간단한 스크립트 작성 작업을 대신 처리합니다.
  • Bot의 대화 턴이 끝난 뒤에도 긴 문서 초안이나 리서치를 진행합니다.
  • 웹훅 알림으로 백그라운드 코딩 작업의 검증된 보고서를 받습니다.
  • Telegram을 통해 휴대폰에서 위임된 에이전트 세션을 실시간으로 확인합니다.

빠른 시작

  1. 1

    Node 22+와 Pi 코딩 에이전트를 설치합니다

    npm i -g --prefix ~/.local @earendil-works/pi-coding-agent
  2. 2

    pi를 대화형으로 실행하고 /login을 입력해 모델에 직접 로그인합니다

  3. 3

    스크립트를 ~/tools/pi-call에 복사합니다

    mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/
  4. 4

    OK가 출력되어야 하는 스모크 테스트를 실행합니다

    ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120

사용 전 알아둘 점

  • Node 22+와 별도의 모델 계정 또는 구독이 필요하며, 직접 인증해야 합니다.
  • Grok Bot 호스트에서 webhook 루틴과 시크릿을 설정해야 하므로 추가 설정 작업이 필요합니다.
  • 경량 헬퍼일 뿐 격리된 샌드박스가 아니며, 강력한 권한 격리를 제공하지 않습니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱AI 코딩 어시스턴트와 에이전트

토픽

#ai-agent#local-agent#webhook#automation#task-queue#coding-agent#telegram

자주 묻는 질문

grokbot-local-agent은(는) 무엇인가요?
Grok Bot이 무거운 코딩·글쓰기 작업을 같은 머신의 로컬 Pi 에이전트에 맡기고, 완료되면 웹훅으로 알림을 받을 수 있게 해주는 스크립트입니다. grokbot-local-agent는 같은 Linux 머신에서 Grok Bot이 로컬 코딩 에이전트인 Pi에 작업을 맡길 수 있게 해주는 스크립트 모음입니다. 여러 파일을 일괄 수정하거나 간단한 스크립트를 작성하고, 긴 초안이나 리서치 자료를 만드는 등의 무거운 작업을 사용자가 보유한 모델 계정으로 Pi에서 실행하므로 Bot의 구독 사용량을 소모하지 않습니다.
grokbot-local-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
grokbot-local-agent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
grokbot-local-agent은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. grokbot-local-agent의 마지막 커밋은 2026년 10월 26일입니다.
grokbot-local-agent은(는) 어디에 사용할 수 있나요?
구독 사용량이 제한된 채팅 봇의 파일 일괄 수정이나 간단한 스크립트 작성 작업을 대신 처리합니다. Bot의 대화 턴이 끝난 뒤에도 긴 문서 초안이나 리서치를 진행합니다. 웹훅 알림으로 백그라운드 코딩 작업의 검증된 보고서를 받습니다. Telegram을 통해 휴대폰에서 위임된 에이전트 세션을 실시간으로 확인합니다.
grokbot-local-agent는 어떻게 설치하나요?
Node 22+와 Pi 코딩 에이전트를 설치합니다: npm i -g --prefix ~/.local @earendil-works/pi-coding-agent pi를 대화형으로 실행하고 /login을 입력해 모델에 직접 로그인합니다 스크립트를 ~/tools/pi-call에 복사합니다: mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/ OK가 출력되어야 하는 스모크 테스트를 실행합니다: ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120
grokbot-local-agent은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/robbin/grokbot-local-agent

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트