Repolode
Enviar
robbin

robbin/grokbot-local-agent

Scripts que permitem ao Grok Bot delegar tarefas pesadas de programação e escrita a um agente Pi local na mesma máquina e ser avisado por webhook quando elas terminarem.

Ver no GitHub
Estrelas
86
Forks
11
Issues abertas
0
Último commit
há 12 dias

O que é?

grokbot-local-agent é um conjunto de scripts para delegar tarefas de um Grok Bot ao Pi, um agente de programação local, na mesma máquina Linux. Tarefas pesadas, como edições em lote de arquivos, scripts pequenos, textos longos e pesquisas, são executadas pelo Pi usando a conta do modelo do próprio usuário, sem consumir a franquia de assinatura do Bot.

Cada chamada delegada é registrada como uma tarefa em ~/.pi/tasks/<ID>/, com status e artefatos armazenados em disco. Quando uma tarefa termina, um webhook recebe apenas o ID, o proprietário, o estado e o código de saída, despertando o Bot para ler os arquivos, verificar o resultado, informá-lo e confirmar a tarefa. Os comandos pending, list e ack filtrados pelo proprietário impedem que vários Bots informem sobre o trabalho uns dos outros, e pending permite que o Bot recupere resultados caso uma notificação não tenha sido recebida.

O projeto é um utilitário leve para a própria máquina do Bot, não um serviço isolado em sandbox. Requer Node 22+ e o script cliente não tem dependências de terceiros.

Recursos principais

  • 01Executa o trabalho delegado pelo agente de programação Pi na mesma máquina.
  • 02Registra cada tarefa com um ID, status e artefatos em disco.
  • 03Envia um webhook ao concluir, para que o Bot possa verificar e informar os resultados.
  • 04Filtra pending, list e ack pelo ID do agente proprietário para evitar que Bots informem sobre o trabalho uns dos outros.
  • 05Oferece suporte a interações de acompanhamento, cancelamento e um atalho síncrono com modelo fixo.
  • 06O monitor opcional do Telegram envia o progresso da sessão do Pi para um chat privado.

Casos de uso

  • Delegar edições em lote de arquivos ou scripts pequenos, evitando consumir a franquia de um bot de chat com assinatura limitada.
  • Executar rascunhos longos de documentos ou pesquisas depois que o turno da conversa do Bot terminar.
  • Receber, por meio de um aviso via webhook, um relatório verificado de uma tarefa de programação executada em segundo plano.
  • Acompanhar ao vivo sessões de agentes delegadas pelo celular usando o Telegram.

Início rápido

  1. 1

    Instale o Node 22+ e o agente de programação Pi

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

    Execute o pi no modo interativo e digite /login para entrar no modelo por conta própria

  3. 3

    Copie os scripts para ~/tools/pi-call

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

    Execute um teste rápido que deve imprimir OK

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

Antes de usar

  • É necessário ter o Node 22+ e uma conta ou assinatura separada do modelo, na qual você deverá se autenticar por conta própria.
  • É preciso configurar uma rotina webhook e um segredo no host do Grok Bot, o que exige trabalho adicional de configuração.
  • É um auxiliar leve, não um sandbox isolado, e não oferece um isolamento robusto de permissões.

Em coleções

Frameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IA

Tópicos

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

Perguntas frequentes

O que é grokbot-local-agent?
Scripts que permitem ao Grok Bot delegar tarefas pesadas de programação e escrita a um agente Pi local na mesma máquina e ser avisado por webhook quando elas terminarem. grokbot-local-agent é um conjunto de scripts para delegar tarefas de um Grok Bot ao Pi, um agente de programação local, na mesma máquina Linux. Tarefas pesadas, como edições em lote de arquivos, scripts pequenos, textos longos e pesquisas, são executadas pelo Pi usando a conta do modelo do próprio usuário, sem consumir a franquia de assinatura do Bot.
grokbot-local-agent é gratuito? Qual é a licença?
grokbot-local-agent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
grokbot-local-agent ainda é mantido?
Manutenção ativa. O último commit de grokbot-local-agent foi em 26 de out. de 2026.
Para que posso usar grokbot-local-agent?
Delegar edições em lote de arquivos ou scripts pequenos, evitando consumir a franquia de um bot de chat com assinatura limitada. Executar rascunhos longos de documentos ou pesquisas depois que o turno da conversa do Bot terminar. Receber, por meio de um aviso via webhook, um relatório verificado de uma tarefa de programação executada em segundo plano. Acompanhar ao vivo sessões de agentes delegadas pelo celular usando o Telegram.
Como instalar grokbot-local-agent?
Instale o Node 22+ e o agente de programação Pi: npm i -g --prefix ~/.local @earendil-works/pi-coding-agent Execute o pi no modo interativo e digite /login para entrar no modelo por conta própria Copie os scripts para ~/tools/pi-call: mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/ Execute um teste rápido que deve imprimir OK: ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120
Onde consigo grokbot-local-agent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/robbin/grokbot-local-agent

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados