ONEDEV

row-bot

AI Agent OrchestrationCLIPython

★ 1,490주당 +19조회 6

무엇인가

Row-Bot은 모델 추론, 도구 호출, 장기 기억, 음성·비전, 메시징 채널을 하나의 데스크톱 애플리케이션에 묶은 로컬 우선 AI 어시스턴트다. 클라우드 구독형 어시스턴트가 차지하던 자리를 사용자 머신 위의 실행 런타임으로 대체한다. 이름 그대로 Reason(지저분한 컨텍스트를 통과하는 추론), Orchestrate(도구와 모델 제공자 조율), Work(파일·저장소·워크플로·채널 안에서의 실행)를 운영 모델로 삼는다.

어떻게 동작하나

동작은 Agent Profile과 Goal Mode를 축으로 한다. 부모 스레드가 보이는 목표를 유지하고, 범위가 정해진 자식 에이전트에게 연구·리뷰·구현·후속 작업을 위임하며, 부모가 자식 결과를 합쳐 응답한다. durable checkpoint가 승인·조정·재시도·중단·복구를 보존하고, 작업 예산과 애플리케이션 전역 위임 한도가 반복 실행을 제한한다. 병렬 작성자는 서로 다른 로컬 폴더를 별도 Developer 워크스페이스로 배정받고, 폴더 단위 잠금으로 공유 폴더 안에서는 한 번에 한 작성자만 쓰도록 보장한다. Auto capability loading은 허용된 핵심 도구를 항상 노출하고, 활성화된 MCP·플러그인·Custom Tool·채널 기능은 요청이 필요로 할 때만 검색한다. 긴 대화에서는 데스크톱 컴포저가 다음 모델 입력 전체를 계량하고, 오래된 턴을 durable untrusted 참조 컨텍스트로 압축하되 최신 턴과 원자적 도구 호출/결과 그룹은 보존한다. 재구성된 프롬프트는 저장 전에 검증된다. 앱 데이터는 기본적으로 로컬에 남고, Windows는 `%USERPROFILE%\.row-bot`, Linux는 `~/.row-bot`에 저장되며 시작 로그는 `row_bot_app.log`에 기록된다. 제공자 키·OAuth 토큰·구독 토큰은 OS 자격 증명 저장소에 보관하고, 공식 Docker 배포는 별도 영구 암호화 키 볼륨과 암호화된 자격 증명 레코드를 쓴다.

무엇과 다른가

구조적 차이는 계정과 추론 서버의 위치에 있다. Row-Bot 자체에는 계정 시스템도, 호스팅 추론 서버도, 1차 텔레메트리 파이프라인도 없다. 제공자 호출은 사용자가 고른 제공자나 엔드포인트로 직접 나가고, 인증된 다중 기기 소유자 접근은 durable trusted address로 처리한다. 모델 경로는 Ollama 로컬 실행, OpenAI·Anthropic·Google AI·xAI·MiniMax·OpenRouter 등 제공자 키, ChatGPT/Codex·Claude Subscription·xAI Grok 구독 또는 OAuth 로그인, oMLX·LM Studio·vLLM·llama.cpp·LocalAI·LiteLLM·SGLang 같은 OpenAI 호환 엔드포인트로 나뉜다. 제공자 정체성, capability 라벨, 추론 선택지, 컨텍스트 한도, 미디어 표면, chat-only 폴백을 명시적으로 관리해 로컬·호스팅·구독·자체 호스팅 모델을 나란히 둔다.

어떻게 쓰나

설치는 GitHub Releases의 설치 프로그램을 쓴다. Windows는 설치 프로그램이 임베디드 Python 런타임과 앱 소스, 의존성을 함께 넣고 시작 메뉴 또는 바탕화면 바로가기로 실행한다. macOS는 DMG의 `Row-Bot.app`을 Applications로 옮기고, 첫 실행 시 인터넷에서 받은 앱 확인을 요구할 수 있다. Linux 설치 프로그램은 릴리스 tarball을 내려받아 GitHub 릴리스 매니페스트의 SHA256을 검증한 뒤 `~/.local/share/row-bot`에 설치하고 `~/.local/bin/row-bot` 실행 파일을 만든다. 설정 단계에서 모델 다운로드를 건너뛰고 제공자 모델이나 커스텀 엔드포인트만 쓸 수 있다. Ollama는 선택 사항이며 로컬 모델에만 필요하다.

전제와 한계

전제 조건과 한계가 명시되어 있다. macOS는 12 이상에서 Apple Silicon과 Intel을 지원하고, Linux 기본 빌드는 시스템 브라우저로 열리며 네이티브 창과 트레이는 GTK·Qt·AppIndicator 라이브러리가 설치된 경우에만 동작한다. Computer Use 베타는 Cua Driver에 의존하고, 별도로 고지된 업스트림 텔레메트리에 동의해야 설치·호출된다. 고정 프롬프트와 도구 스키마가 선택한 컨텍스트 윈도우에 들어가지 않으면 정확한 용량 메시지와 함께 실패한다. 앱 재시작이 위임이나 소유 셸 작업을 중단시키면 응답 없는 도구 호출을 재생하지 않고 닫은 뒤, 필요한 자식 결과가 준비됐을 때 저장된 부모를 재개한다.

관련 논문 2

유사 도구