← 목록으로

Prospero - 경량 설계와 원격 실행을 지원하는 새로운 코딩 하네스

요약
  • Prospero는 C++와 Dear ImGui를 기반으로 한 경량 코딩 하네스로, 로컬 및 외부 모델을 연결해 병렬 작업과 원격 실행을 지원합니다.
  • 낮은 메모리 사용량과 프로세스 트리 관리 기능을 갖춰 효율적인 프로그래밍 작업 및 GUI 애플리케이션 테스트가 가능합니다.
  • C++와 Dear ImGui로 만든 네이티브 GUI 코딩 하네스로, Windows, macOS, Linux에서 실행됨. 로컬 모델이나 외부 모델 API를 연결해 사용함
  • 서브에이전트의 병렬 작업과 원격 실행을 지원하며, 시각 기능이 있는 모델은 화면을 보고 클릭하거나 입력해 GUI 앱을 테스트하고 디버깅할 수 있음
  • 무한 대기를 피하는 설계로 네트워크 요청과 권한 응답에 시간제한을 적용함. 오래 걸리는 셸 명령은 백그라운드 작업으로 전환하고 에이전트가 주기적으로 상태를 확인함
  • 명령 중단 시 전체 프로세스 트리를 함께 종료해 자식 프로세스가 남는 문제를 방지함. GUI도 유휴 상태에서는 화면을 계속 다시 그리지 않아 자원 사용을 줄임
  • 모델 제공자는 직접 설정해야 하며 Claude 구독은 사용할 수 없음. 무료 Community Edition과 여러 플랫폼의 원격 실행 엔진을 내장한 유료 Professional Edition을 제공함
경량 코딩 하네스의 설계
  • Prospero는 로컬 모델로 간단한 프로그래밍 작업을 수행할 수 있을 만큼 오픈 웨이트 모델의 신뢰성이 높아진 상황에서, 기존 하네스의 큰 메모리 사용량에 대한 불만으로 시작됨
    • 일부 모델은 일반적인 고성능 소비자용 하드웨어에서도 감당할 만한 속도로 실행할 수 있음
    • 코딩 하네스의 핵심은 사실상 curl과 popen()을 연결하는 것이므로 기가바이트 단위 RAM이 필요해서는 안 된다는 설계를 따름
  • C++ 스타일과 Dear ImGui 도킹 인터페이스를 사용하며 다크 모드도 지원함
    • 개발자에 따르면 기능을 희생하지 않고 다른 하네스보다 약 100배 적은 자원을 사용함
  • 모델 제공자는 내장하지 않음

    • llama.cpp, 사내 온프레미스 모델, OpenRouter, Anthropic API, OpenAI API 등을 직접 연결해야 함
    • Claude 구독은 사용할 수 없음
에이전트, 원격 실행과 데스크톱 제어
  • 코딩 하네스는 채팅 인터페이스에 파일 읽기/쓰기와 셸 명령 실행 등의 도구를 추가함
    • 에이전트는 도구 호출 결과를 받아 다음 도구를 호출하는 과정을 자율적으로 반복함
    • 필요할 때 사용자에게 진행 상황을 알리거나 질문하며, 일반 채팅도 유지됨
  • 서브에이전트는 작업을 병렬로 처리하거나 하위 작업으로 주 에이전트의 컨텍스트가 채워지는 것을 줄이는 데 쓰임
    • 에이전트끼리 메시지를 보내고 작업을 조율할 수 있음
  • SSH 접근이나 WSL을 통해 다른 호스트에 헤드리스 엔진을 배포하고, 해당 시스템에서 에이전트를 실행할 수 있음
    • Professional Edition은 macOS, Windows, Linux의 x86/x86-64 및 ARM64 조합에 대응하는 엔진을 내장함
    • Windows x86 엔진은 Windows XP에서도 동작하며, 요청하면 솔리테어와 지뢰찾기를 플레이할 수 있음
  • 데스크톱 제어는 시각 기능을 지원하는 모델이 화면을 보고 클릭, 입력, 드래그할 수 있게 함
    • 앱별로 특화된 MCP 보조 기능 없이도 실행 중인 GUI 애플리케이션을 테스트하고 디버깅할 수 있음
  • 엔진은 헤드리스 시스템에서, GUI는 데스크톱이나 노트북에서 실행하므로 별도의 TUI가 필요하지 않음
    • 추가 설정을 하면 GUI 연결이 끊겨도 엔진이 독립적으로 계속 실행되고, 나중에 다시 연결할 수 있음
  • 낮은 메모리 사용량은 퍼징 작업에도 중요함
    • 개발자는 퍼징 대상이 메모리를 과도하게 사용했을 때 Linux OOM killer가 오히려 메모리를 많이 쓰는 하네스를 종료해 작업이 중단되는 일을 반복해서 겪음
    • 에이전트가 발견한 버그를 즉시 수정하면 퍼징을 계속 진행할 수 있음
INI 설정과 공유 구성
  • 설정은 ~/.config/prospero/prospero.ini 에 저장하며, 소스 관리에 넣거나 복사해서 사용할 수 있음
    • GUI의 Settings 페이지에서도 모든 설정에 접근할 수 있어 직접 파일을 편집할 필요는 없음
  • INI 파일은 로컬 경로뿐 아니라 URL의 다른 INI 파일도 포함할 수 있어, 실시간으로 공유하거나 관리하는 구성을 만들 수 있음
    • URL에서 불러온 설정은 셸 명령에 들어갈 수 있는 항목을 지정하지 못하도록 제한함
    • 다만 환경변수를 API 키로 사용하고 공격자가 제어하는 엔드포인트를 지정하면 값을 유출할 수 있으므로, 설정에 대한 신뢰는 여전히 필요함
  • 엔드포인트에서 모델 목록과 컨텍스트 크기 등의 매개변수를 가져오며 필요에 따라 조정할 수 있음
    • 설정 예시에는 환경변수 기반 API 키, 모델별 편집 형식과 추론 노력 수준, 기존 모델 설정을 상속하는 변형, SearXNG 웹 검색 설정이 포함됨
유휴 렌더링과 무한 대기 방지
  • 일반적인 ImGui의 수직 동기화 기반 능동 렌더링 대신 수동 렌더링(passive rendering) 을 사용함
    • 애니메이션을 마무리하는 정착 프레임(settle frames)을 처리한 뒤 유휴 상태로 들어감
    • 에이전트가 빌드를 기다리는 등 할 일이 없을 때 GPU를 계속 사용하지 않음
  • 핵심 설계 원칙은 “영원히 기다리지 않는다”이며, 모든 작업에 마감 시간을 둠
    • 권한 요청에 사용자가 응답하지 않으면 시간 초과로 거부 처리하고, 에이전트는 그 권한 없이 진행해야 함
    • 사용자의 주의가 필요하면 시스템 토스트 알림을 띄움
  • 일시적인 오류가 있어도 가능한 한 작업을 계속하며, 모든 네트워크 요청에 시간제한을 적용함
    • 감시 장치로 끝없는 대기를 막고, 에이전트 메시지함에도 용량 제한을 둠
  • 시간이 초과된 셸 명령은 비동기 백그라운드 작업으로 전환함
    • 에이전트는 다시 시간제한을 두고 기다릴 수 있으며, 주기적으로 깨어나 계속 기다릴지 판단함
  • Plan 모드는 예외로, 계획을 제안하거나 ask_user 도구로 추가 설명을 요청한 뒤 무기한 대기함
    • 이 모드에서는 사용자가 에이전트와 함께 작업 중이라고 전제함
남는 프로세스 없이 명령 종료
  • 빌드 시스템 일부만 종료하면 자식 프로세스가 계속 실행될 수 있음
    • 에이전트가 빌드가 멈췄다고 판단해 재시도하면 두 빌드가 동시에 실행되어 서로 간섭하고 시스템에 과부하를 줄 수 있음
  • Prospero는 전체 프로세스 트리의 수명을 함께 관리하므로, 명령을 중단하면 그 트리 전체가 종료됨
    • Windows에서는 Job Objects로 쉽게 구현할 수 있음
    • macOS와 Linux에서는 더 어렵지만 같은 원칙을 적용함
  • 동기 명령의 시간 초과를 비동기 작업으로 바꾸는 방식과 프로세스 정리를 결합해, 에이전트가 빌드와 검증을 자율적으로 반복하도록 함
    • 사람이 매번 개입해야 한다면 에이전트의 이점 대부분을 잃게 됨
자체 도움말과 셸 전환
  • 작업 수행 지침을 묶은 스킬을 지원하며, Prospero 자체 사용법에 대한 스킬과 내장 문서도 제공함
    • 에이전트가 사용법이나 설정 질문에 답하고, 해당 GUI 위치로 이동하는 링크를 제공할 수 있음
    • prospero.ini를 수정하고 다시 불러와 사용자를 대신해 설정할 수도 있음
  • Windows에서는 w64devkit과 잘 동작하도록 설계했으며, 설치되어 있으면 그 셸을 우선 사용함
    • 코딩용 모델은 w64devkit을 별도 교육 없이 알고 있어 함께 활용할 수 있음
    • 다른 기본 셸도 자유롭게 선택할 수 있음
  • 세션 도중에도 셸을 변경할 수 있음
    • 작업에 따라 드롭다운에서 PowerShell 등으로 전환하면 에이전트에 변경 사실과 오래된 Bash 같은 알려진 특성을 전달함
    • macOS에서는 bash와 zsh 사이를 전환할 수 있음
일반 기능과 보안 경계
  • Git worktree를 지원하며 서브에이전트도 별도 worktree를 사용해 같은 저장소에서 작업할 수 있음
    • Model Context Protocol(MCP), 허용 시 웹 검색, 컨텍스트를 공유하는 서브에이전트 기반 보조 채팅, 세션 분기도 지원함
  • 현재 내장 터미널과 편집기는 없음
    • 사용자가 선택한 외부 터미널이나 편집기를 열며, Ctrl+G로 프롬프트를 외부 편집기에서 작성할 수 있음
  • 권한 시스템은 악의적인 에이전트를 막는 보안 경계가 아님

    • 에이전트는 프로그램을 작성하고 실행하므로 궁극적으로 하네스가 접근할 수 있는 모든 자원에 접근할 수 있음
    • 권한은 프로젝트 범위를 지키거나 데스크톱 제어를 하지 말라는 사용자 의사를 상기시키고 단순한 실수를 잡는 용도임
    • 실제 접근을 차단하려면 하네스 자체를 격리해야 함
    • 컨테이너나 Raspberry Pi 등에서 실행할 수 있지만, 사용이 불편해지거나 유용한 자원에 접근하지 못하는 대가가 따름
Community Edition과 Professional Edition
  • Unlicense로 공개된 오픈소스
  • 오픈 소스 프로젝트이지만, 개발 비용과 상업 제품을 만드는 전문가의 사용 가능성을 고려해 두 등급으로 나눔
    • 개발자는 자신의 기존 프로젝트 이용자 상당수가 취미 개발자이지만, Prospero가 더 널리 쓰이면 전문가 사용자가 다수가 될 것으로 예상함
  • Community Edition은 GitHub에서 무료로 제공하며 취미 개발자에게 적합함
    • 헤드리스 엔진을 내장하지 않아 원격 배포가 제한됨
    • Community Edition 사용 중임을 알리는 짧은 안내 문구가 있음
  • Professional Edition은 소액을 지불하고 DRM 없는 빌드를 내려받는 방식이며, 업데이트는 무료임
    • 모든 헤드리스 엔진을 내장해 버튼 한 번으로 다른 시스템에 원격 배포하고 원격 세션을 시작할 수 있음
  • 두 등급 모두 Windows와 macOS 빌드에 코드 서명을 적용함
    • 개발자는 원격 배포 기능을 사용하지 않더라도 업무에 유용하다면 지속적인 비용을 지원하기 위해 구매해 달라고 요청함
그냥 목록으로
원문 보기 ↗