Un agente minimalista trasladado a Python, partiendo de `pi-mono`, el núcleo de OpenClaw

Creo que para muchas personas los agentes siguen siendo algo un poco abstracto. Parecen algo impresionante, pero cuando uno los abre por dentro, muchas veces no queda claro cómo funcionan realmente ni por dónde empezar a meterles mano.

A mí me pasaba algo parecido. Entonces escuché que el núcleo de OpenClaw era pi-mono, y me impresionó que se tratara de un agente tan minimalista. En particular, sentí que representaba muy bien la filosofía de que "lo más poderoso es un sistema simple". Así que decidí tomarlo como punto de partida para crear mi propio agente y trasladarlo a Python, al menos hasta un nivel en el que pudiera escribir código automáticamente.

La verdad es que en el py-pimono actual todavía faltan muchas cosas que ya existen en pi-mono. Por ejemplo:

• gestión de sesiones
• steering
• seguimiento
• varias utilidades
• streaming

Por eso, py-pimono está más cerca de ser un agente casi reducido al esqueleto, uno que prácticamente no tiene nada pero al menos funciona, que de un producto terminado. A cambio, deja su estructura bastante clara, para que sea fácil hacerse una idea de qué abrir, dónde mirar y qué se puede agregar. Por eso pensé que también podría servirles a quienes todavía ven a los agentes como algo difuso, ya que pueden seguir la estructura e intervenirla directamente. Quise hacerlo de manera que fuera posible explorar preguntas como estas dentro de una base de código lo más pequeña posible.

• A algunas personas les dará curiosidad cómo se expresa en código eso de que "un agente sigue ejecutándose de forma sostenida"
• A otras les interesará cómo se guardan y se vuelven a cargar los datos de sesión

Así que pensé que estaría bien que este repositorio sirviera como punto de partida para separar esas partes lo más posible y, leyendo y analizando el código junto con un LLM, probar a conectar tu propio loop o tu propia gestión de sesiones, e ir ampliando la estructura poco a poco.

Eso sí, para que se pueda ejecutar de inmediato y agarrarle la mano, dejé también una UI montada sobre este harness minimalista. Si abres el directorio ui/, también podrás encontrar varias interfaces con las que estuve experimentando, junto con una integración con Discord.

Instalación:

pip install py-pimono  

Si ya tienes autenticación de Codex, puedes ejecutarlo directamente.

pyai  

Incluso si no tienes autenticación de Codex, como fallback corre el loro MockLlm, así que también es bastante entretenido mirar el loop del agente poniendo puntos de depuración.

Si todavía no tienes autenticación de Codex, primero inicia sesión y luego ejecútalo.

codex login  
pyai  

Después, pensé que sería interesante ir agregando junto con ustedes, de la forma más limpia y minimalista posible, solo esas piezas realmente importantes que todavía faltan aquí. Lo comparto porque me gustaría que, en lugar de dejar a los agentes como algo abstracto, más personas pudieran experimentar la sensación de abrirlos, modificarlos y hacerlos propios.