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
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트