siddsachar/row-bot

Row-Bot - Personal AI Sovereignty. A local-first AI assistant with integrated tools, a personal knowledge graph, voice, vision, shell, browser automation, scheduled tasks, health tracking, and messaging channels. Run locally via Ollama or add opt-in cloud models. Your data stays on your machine.

Row‑Bot – 로컬 우선 AI 어시스턴트

소개 – Row‑Bot(이전 명칭 Thoth)은 AI와 대화하며 파일, 코드, 디자인 에셋 및 외부 서비스를 조작할 수 있는 데스크톱 애플리케이션입니다. 완전히 자신의 기기(또는 개인 Docker 서버)에서 실행되며 데이터를 클라우드에 저장하지 않습니다.

주요 기능

  • 대화형 워크플로우 – 채팅을 시작하여 프레젠테이션 자료 제작, 코드 리뷰, 알림 설정 등을 요청할 수 있습니다. Row‑Bot은 적절한 폴더를 생성하고, 파일을 작성하며, 도구를 실행하고 대화 맥락을 유지합니다.
  • 메모리 및 지식 그래프 – 개인 그래프가 사실, 문서 및 “드림 사이클” 개선 사항을 저장하여 나중에 검색할 수 있습니다.
  • 목표 및 에이전트 – 장기적인 목표는 완료될 때까지 지속됩니다. 고유한 채팅을 가진 전문 에이전트를 생성하여 중지하거나 메시지를 보낼 수 있습니다.
  • 승인 프로세스 – 위험한 작업(예: 명령 실행, 게시)은 사용자의 명시적인 Approve(승인)/Deny(거부)가 있을 때까지 일시 중지됩니다.
  • 도구 통합 – 웹 검색, 셸, 파일 브라우저, 관리형 브라우저, 컴퓨터 제어(Windows/macOS), Gmail/Calendar, 이미지/비디오 생성 및 사용자 지정 도구.
  • 채널 및 음성 – Telegram, WhatsApp, Discord, Slack, SMS 및 로컬 Whisper/SenseVoice와 TTS를 통한 받아쓰기 및 읽어주기.
  • 앱 및 스킬 – GitHub, Notion, Linear, Stripe 등과의 원클릭 연결 및 재사용 가능한 “스킬” 카탈로그.
  • 워크플로우 – 예약 실행, Webhook 트리거 또는 승인 프로세스를 포함한 체인 실행 및 채널 전달.
  • 원격 / 멀티 디바이스 – 소유자는 다른 신뢰할 수 있는 기기(QR 코드, Tailscale, LAN, SSH 터널, Docker)를 초대하여 모든 내용을 동기화할 수 있습니다.

실행 환경

  • 백엔드는 Python으로 작성된 FastAPI 서버이며, 에이전트 오케스트레이션에 LangGraph/LangChain, 벡터 메모리에 FAISS를 사용하고, 옵션으로 Ollama를 통한 로컬 모델을 활용합니다.
  • UI는 /app‑v2/에서 제공되는 React 단일 페이지 앱으로, 네이티브 창, 브라우저 또는 모바일에서 열 수 있습니다.
  • 네이티브 실행(Windows 설치 프로그램, macOS DMG, Linux tarball) 또는 Docker 컨테이너(ghcr.io/siddsachar/row-bot)로 실행할 수 있습니다.

설치

  • Windows/macOS: GitHub 릴리스 페이지에서 설치 프로그램을 다운로드하세요.
  • Linux: 한 줄 스크립트로 ~/.local/share/row-bot에 설치하고 row-bot 명령을 ~/.local/bin에 추가합니다.
  • Docker: docker compose -f deploy/docker/compose.yaml up을 실행한 후 CLI를 통해 기기를 초대하세요.

설정 및 데이터

  • 데이터는 ~/.row-bot(또는 %USERPROFILE%\.row-bot)에 저장됩니다. 보안 정보는 OS의 키체인/자격 증명 관리자에 저장되며, Docker는 암호화된 볼륨을 사용합니다.
  • 작업 공간 파일은 기본적으로 ~/Documents/Row-Bot이지만 설정 가능합니다.
  • CLI(row-bot serve, row-bot access invite 등)를 사용하여 헤드리스 서버 시작, 초대 관리 및 상태 확인이 가능합니다.

개발

  • 소스 구조: src/row_bot/(백엔드) 및 frontend/(React 클라이언트).
  • Python 3.12/3.13으로 빌드하며, 의존성 관리에 uv, UI에 Node 24를 사용합니다.
  • 테스트는 scripts/run_test_matrix.py에 의해 오케스트레이션됩니다. CI는 빠른 테스트, 변경 파일 테스트, PR 테스트, 플랫폼별 테스트 및 브라우저 스모크 테스트 스위트를 실행합니다.

개인정보 보호 및 안전

  • 계정 시스템, 호스팅된 추론, 자사 원격 측정(telemetry)이 없습니다. 모든 대화, 메모리 및 파일은 기기에 보관됩니다. 공급자 API 호출은 선택한 엔드포인트(Ollama, OpenAI 호환, ChatGPT, Claude, Grok 등)로 직접 전송됩니다.
  • 선택적 “컴퓨터 제어” 기능(베타)은 업스트림 드라이버 원격 측정에 대한 명시적인 동의가 필요합니다.

라이선스 – Apache 2.0.


Row‑Bot은 대화형 LLM 상호 작용과 로컬 도구, 메모리 및 멀티 디바이스 액세스를 결합한 완전한 기능을 갖춘 셀프 호스팅 AI 어시스턴트입니다. 데이터에 대한 통제권을 유지하면서 강력한 자동화를 원하는 사용자를 위해 설계되었습니다.

관련

  • Dispatch
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트