Repolode
Enviar
robbin

robbin/grokbot-local-agent

Scripts para que Grok Bot delegue tareas complejas de programación y redacción a un agente Pi local en la misma máquina y se reactive mediante un webhook al terminar.

Ver en GitHub
Estrellas
83
Forks
10
Issues abiertos
0
Último commit
hace 11 días

¿Qué es?

grokbot-local-agent es un conjunto de scripts para delegar trabajo de Grok Bot a Pi, un agente de programación local, en la misma máquina Linux. Las tareas pesadas, como editar varios archivos por lotes, crear scripts pequeños, redactar textos extensos e investigar, se ejecutan con Pi usando la cuenta del usuario para el modelo, por lo que no consumen la cuota de suscripción del Bot.

Cada llamada delegada se registra como una tarea en ~/.pi/tasks/<ID>/, con su estado y sus artefactos guardados en disco. Cuando termina una tarea, un webhook recibe solo su ID, propietario, estado y código de salida; esto reactiva al Bot para que lea los archivos, verifique el resultado, lo comunique y confirme la tarea. Los comandos pending, list y ack filtrados por propietario evitan que varios Bots informen sobre el trabajo de los demás, y pending permite al Bot recuperar resultados si no recibió una notificación.

El proyecto es una herramienta auxiliar ligera para la propia máquina del Bot, no un servicio de entorno aislado. Requiere Node 22+ y su script cliente no tiene dependencias de terceros.

Funciones clave

  • 01Ejecuta el trabajo delegado con el agente de programación Pi en la misma máquina.
  • 02Registra cada tarea con un ID, estado y artefactos en disco.
  • 03Envía un webhook al terminar para que el Bot pueda verificar e informar los resultados.
  • 04Filtra pending, list y ack por el ID del agente propietario para evitar que los Bots informen sobre el trabajo de los demás.
  • 05Admite turnos de seguimiento, cancelación y una opción síncrona rápida con un modelo fijo.
  • 06El monitor opcional de Telegram envía el progreso de las sesiones de Pi a un chat privado.

Casos de uso

  • Delegar ediciones de varios archivos por lotes o scripts pequeños para no consumir la cuota de un bot de chat con suscripción limitada.
  • Redactar documentos extensos o investigar mientras el turno de conversación del Bot ya ha terminado.
  • Obtener mediante la reactivación por webhook un informe verificado de una tarea de programación ejecutada en segundo plano.
  • Seguir en tiempo real sesiones de agentes delegadas desde un teléfono mediante Telegram.

Inicio rápido

  1. 1

    Instala Node 22+ y el agente de programación Pi

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

    Inicia pi en modo interactivo y escribe /login para iniciar sesión en el modelo

  3. 3

    Copia los scripts en ~/tools/pi-call

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

    Ejecuta una prueba de humo que debería mostrar OK

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

Antes de usarlo

  • Necesitas Node 22+ y una cuenta o suscripción independiente para el modelo, en la que tendrás que autenticarte personalmente.
  • Requiere configurar una rutina webhook y un secreto en el host de Grok Bot, lo que añade trabajo de configuración.
  • Es una herramienta auxiliar ligera, no un sandbox aislado, y no ofrece un aislamiento sólido de permisos.

En colecciones

Frameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IA

Temas

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

Preguntas frecuentes

¿Qué es grokbot-local-agent?
Scripts para que Grok Bot delegue tareas complejas de programación y redacción a un agente Pi local en la misma máquina y se reactive mediante un webhook al terminar. grokbot-local-agent es un conjunto de scripts para delegar trabajo de Grok Bot a Pi, un agente de programación local, en la misma máquina Linux. Las tareas pesadas, como editar varios archivos por lotes, crear scripts pequeños, redactar textos extensos e investigar, se ejecutan con Pi usando la cuenta del usuario para el modelo, por lo que no consumen la cuota de suscripción del Bot.
¿grokbot-local-agent es gratuito? ¿Qué licencia tiene?
grokbot-local-agent es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿grokbot-local-agent sigue mantenido?
Mantenimiento activo. El último commit de grokbot-local-agent fue el 26 oct 2026.
¿Para qué puedo usar grokbot-local-agent?
Delegar ediciones de varios archivos por lotes o scripts pequeños para no consumir la cuota de un bot de chat con suscripción limitada. Redactar documentos extensos o investigar mientras el turno de conversación del Bot ya ha terminado. Obtener mediante la reactivación por webhook un informe verificado de una tarea de programación ejecutada en segundo plano. Seguir en tiempo real sesiones de agentes delegadas desde un teléfono mediante Telegram.
¿Cómo se instala grokbot-local-agent?
Instala Node 22+ y el agente de programación Pi: npm i -g --prefix ~/.local @earendil-works/pi-coding-agent Inicia pi en modo interactivo y escribe /login para iniciar sesión en el modelo Copia los scripts en ~/tools/pi-call: mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/ Ejecuta una prueba de humo que debería mostrar OK: ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120
¿Dónde consigo grokbot-local-agent?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/robbin/grokbot-local-agent

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados