Um agente minimalista em Python, partindo do pi-mono, o núcleo do OpenClaw

Acho que, para muita gente, agentes ainda são algo um pouco abstrato. Parece algo impressionante, mas, quando vamos ver por dentro, muitas vezes não fica claro como funciona na prática nem por onde começar a mexer.

Comigo foi parecido. Aí ouvi dizer que o núcleo do OpenClaw é o pi-mono, e achei marcante o fato de ele ser um agente extremamente minimalista. Em especial, senti que ele representa muito bem a filosofia de que "os sistemas mais poderosos são os simples". Então resolvi usá-lo como ponto de partida para criar meu próprio agente e portar isso para Python, pelo menos até o nível de conseguir escrever código automaticamente.

Na verdade, o py-pimono atual ainda não inclui muitas coisas que já existem no pi-mono. Por exemplo:

• gerenciamento de sessão
• steering
• follow-up
• vários utilitários
• streaming

Por isso, o py-pimono está mais próximo de um agente quase só com o esqueleto — algo que praticamente não tem nada, mas já funciona — do que de um produto completo. Em compensação, a estrutura foi deixada relativamente explícita, para facilitar entender o que abrir, onde mexer e o que conectar em cada parte. Por isso, achei que ele também seria uma boa opção para quem ainda vê agentes como algo abstrato e quer explorar a estrutura com as próprias mãos. Quis permitir que perguntas como estas pudessem ser investigadas dentro de uma base de código o menor possível:

• algumas pessoas podem querer saber como a ideia de "um agente continuar rodando por longos períodos" é expressa no código
• outras podem querer saber como os dados de sessão são salvos e carregados novamente

Por isso, pensei neste repositório como um bom ponto de partida para manter essas partes o mais separadas possível e permitir que você leia e analise o código com a ajuda de um LLM, adicionando seu próprio loop ou gerenciamento de sessão e expandindo a estrutura aos poucos.

Ainda assim, para que seja possível executar e pegar prática imediatamente, deixei uma UI junto em cima desse harness minimalista. Se você abrir o diretório ui/, também vai encontrar várias UIs com as quais eu estava brincando, além de uma integração com o Discord.

Instalação:

pip install py-pimono  

Se a autenticação do Codex já estiver feita, basta executar direto.

pyai  

Mesmo sem autenticação do Codex, o papagaio MockLlm roda como fallback, então também é bem divertido acompanhar o loop do agente marcando pontos de depuração.

Se você ainda não tiver autenticação do Codex, faça login primeiro e depois execute.

codex login  
pyai  

Depois disso, achei que seria interessante construir junto com vocês apenas as partes realmente importantes que ainda faltam, de forma o mais limpa e minimalista possível. Em vez de deixar agentes como algo vago e distante, quis compartilhar isso para que mais pessoas possam abrir, modificar e transformar em algo seu.