Show GN: OpenClaw의 코어인 pi-mono에서 출발해 Python으로 옮겨 본 미니멀 에이전트

아직 많은 사람들에게 에이전트는 조금 막연한 존재라고 생각합니다. 뭔가 대단해 보이지만, 실제로 안을 열어보면 어떻게 돌아가는지 감이 잘 안 오고, 어디서부터 만져봐야 하는지도 선뜻 잡히지 않는 경우가 많습니다.

저도 비슷했습니다. 그러다 OpenClaw의 코어가 pi-mono라는 이야기를 들었고, 이게 굉장히 미니멀한 에이전트라는 점이 인상 깊었습니다. 특히 저는 그것이 "가장 강력한 것은 단순한 시스템"이라는 철학을 잘 대변하는 예처럼 느껴졌습니다. 그래서 이걸 나만의 에이전트를 만들기 위한 시작점으로 삼아, 자동으로 코드를 작성할 수 있는 수준까지만 Python으로 한번 옮겨 보기로 했습니다.

사실 지금의 py-pimono에는 pi-mono에 이미 있지만 아직 들어오지 않은 것들이 훨씬 많습니다. 예를 들면 이런 것들입니다.

• 세션 관리
• 스티어링
• 팔로우업
• 각종 유틸리티
• 스트리밍

그렇게 해서 py-pimono는 완성형 제품이라기보다, 정말 아무것도 없는데 일단 돌아가기는 하는, 거의 뼈대만 남겨 둔 에이전트에 가깝습니다. 대신 구조를 비교적 또렷하게 드러내 두어서, 어디를 열어 보고 어디에 무엇을 붙이면 되는지 감을 잡기 쉽도록 만들었습니다. 그래서 아직 에이전트가 막연한 사람들도 구조를 따라가며 손을 대 보기 좋겠다고 생각했습니다. 예를 들면 이런 질문들을 가능한 한 작은 코드베이스 안에서 따라가 볼 수 있게 만들고 싶었습니다.

• 누군가는 "에이전트가 긴 호흡으로 계속 돌아간다"는 것이 코드에서 어떻게 표현되는지가 궁금할 것이고
• 누군가는 세션 데이터를 어떻게 저장하고 다시 불러오는지가 궁금할 것입니다

그래서 이 저장소는 그런 것들을 최대한 분리해 두고, LLM과 함께 코드를 읽고 분석하면서 당신만의 루프나 세션 관리를 붙여 보고 구조를 조금씩 확장해 가기 좋은 출발점이 되면 좋겠다고 생각했습니다.

다만 바로 실행해 보고 손에 익혀 볼 수 있도록, 이 미니멀한 하네스 위에 UI는 함께 붙여 두었습니다. ui/ 디렉토리를 열어 보면, 제가 이것저것 가지고 놀아 보던 여러 UI와 디스코드 연결도 같이 발견할 수 있습니다.

설치:

pip install py-pimono  

Codex 인증이 이미 되어 있다면 바로 실행하면 됩니다.

pyai  

Codex 인증이 없어도 fallback으로 앵무새 MockLlm이 돌기 때문에, 디버깅 포인트를 찍어가며 에이전트 루프를 구경해 보는 것도 꽤 재미있습니다.

Codex 인증이 아직 없다면 먼저 로그인한 뒤 실행하면 됩니다.

codex login  
pyai  

이후에는 여기서 진짜 중요하지만 아직 빠져 있는 것들만, 최대한 깔끔하고 미니멀하게 붙여 가는 작업을 여러분과 같이 해 보면 재미있겠다고 생각했습니다. 에이전트를 막연한 대상으로 남겨 두기보다, 직접 열어 보고, 고쳐 보고, 자기 것으로 바꿔 보는 감각을 더 많은 분들이 느껴 봤으면 해서 올려 봅니다.