Bitterbot-AI/bitterbot-desktop

Bitterbot – 로컬 우선 개인용 AI

무엇인가요 – Bitterbot은 사용자의 컴퓨터에서 자체적으로 작동하는 오픈소스 데스크톱 애플리케이션입니다. 일반적인 챗봇이 사용자의 프롬프트를 원격 LLM에 전달하는 것과 달리, Bitterbot은 생물학적으로 영감을 받은 지속 가능한 기억을 유지하고, 도구(웹 브라우징, 코드 실행, WhatsApp 메시지 전송)를 실행할 수 있으며, 주기적으로 "꿈"을 꾸어 학습 내용을 통합합니다. 또한 소규모 피어 투 피어(P2P) 마켓플레이스를 포함하고 있어 에이전트가 검증된 기술을 USDC로 판매할 수 있지만, 금전적 요소는 선택 사항입니다.

핵심 개념

• 생물학적 스타일의 기억 – 사실은 지식 크리스탈로 저장되며, 강화되지 않으면 소멸되며, 에빙하우스의 망각 곡선을 모방합니다. 도파민, 코르티솔, 옥시토신 등의 호르몬 시스템이 각 턴마다 에이전트의 톤과 집중도를 조절합니다.
• 드림 엔진 – 몇 시간마다 에이전트는 오프라인 상태가 되고, 리플레이, 변이, 압축, 연구 등 다양한 "드림" 모드를 실행하여 기억을 재구성하고 새로운 재사용 가능한 기술을 생성하며, 드림 품질 점수로 결과를 평가합니다.
• 지속적 리콜 – 쿼리가 토큰 윈도우를 초과할 경우, Bitterbot은 1000만 토큰의 전체 기록을 검색하는 사전화된 서브-LLM을 생성하고 결과를 캐시합니다.
• 실행 가능한 기술 및 인터셉터 – 기술은 마크다운으로 정의되지만, 결정론적 코드 인터셉터로 보호되며, 에이전트의 호르몬 상태를 확인하고 도구 호출을 수정, 승인, 또는 차단할 수 있습니다.
• P2P 기술 마켓플레이스 – 에이전트는 검증된 기술(Ed25519 서명 포함)을 게시하고 Base 테스트넷에서 USDC를 수익화할 수 있습니다. 지갑은 기본적으로 비활성화되어 있습니다.

시작 방법

1. Node ≥ 22 설치 (리포지토리에는 Corepack이 포함되어 있음). pnpm 활성화:

   corepack enable pnpm || npm install -g pnpm
   

2. 리포지토리 복제 및 제공된 스크립트로 시스템 종속성(ffmpeg, ripgrep, jq 등) 설치:

   git clone https://github.com/Bitterbot-AI/bitterbot-desktop.git && cd bitterbot-desktop
   bash scripts/setup-deps.sh
   pnpm install
   pnpm exec playwright install --with-deps chromium
   

3. 온보딩 워즈드 실행: Anthropic, OpenAI, Tavily, Brave 등 API 키 입력, 메모리 임베딩 설정, 채널 구성, 선택적 지갑 생성:

   pnpm bitterbot onboard
   

4. 워즈드 완료 후 게이트웨이와 컨트롤 UI가 자동으로 시작됩니다. 브라우저에서 http://127.0.0.1:19001을 열어 대화, 드림 보기, 기술 관리, 에이전트 모니터링을 수행합니다.
5. 개발용으로는 워치 모드 사용 가능:

   pnpm dev:all          # 게이트웨이 + Vite UI의 핫리로드
   # 또는 두 개의 터미널로 분리
   pnpm gateway:watch
   cd desktop && pnpm dev
   

주요 구성 요소

서비스	URL	역할
게이트웨이	ws://127.0.0.1:19001	UI, CLI, 외부 클라이언트가 사용하는 WebSocket API
컨트롤 UI	http://127.0.0.1:19001	브라우저 기반 대시보드로 채팅, 드림, 기술 라이브러리, 진단 정보 표시
오케스트레이터 (P2P 사이드카)	게이트웨이에 의해 자동으로 생성	분산형 기술 교환 및 지갑 상호작용 처리

일반적인 사용 사례

• 개인 지식 어시스턴트 – 프로젝트 세부 정보, 과거 대화, 선호 사항을 반복적으로 LLM에 프롬프트하지 않고 기억합니다.
• 도구 증강형 자동화 – 웹을 탐색하거나, 쉘 명령어를 실행하거나, WhatsApp 메시지를 대신 전송할 수 있습니다.
• 연구 보조 – 드림 엔진의 연구 모드는 정보를 자동으로 가져와 재사용 가능한 기술로 저장합니다.
• 실험 플랫폼 – 개발자는 새로운 기억 아키텍처, 호르몬 모델, 또는 기술 인터셉터를 프로토타이핑하고 로컬에서 실행해 볼 수 있습니다.

제한 사항 및 현재 상태

• 금전 기능(USDC 지갑, P2P 기술 거래)은 선택적이고 실험적입니다. 테스트넷에서 작동하며 명시적인 구성이 필요합니다.
• 기억 통합 및 드림 사이클은 CPU 집약적입니다. 문서는 최신 데스크톱을 권장하며, 기계가 비활성 상태일 때만 드림 엔진을 실행하는 것을 제안합니다.
• 시스템은 대부분의 추론에 외부 LLM API(Anthropic, OpenAI 등)에 의존합니다. 딥 리콜용 서브-LLM만 로컬에서 사전화되어 있습니다.
• Windows 지원은 WSL2에 한정되어 있으며, 네이티브 Windows 실행은 공식적으로 테스트되지 않았습니다.
• 최신 릴리스(2026.2.15) 기준으로 프로젝트는 여전히 활발히 개발 중이며, 일부 문서(LIMITATIONS.md)는 특정 기능이 변경될 수 있음을 경고하고 있습니다.

더 알아보기

• 문서 – docs/에는 기억 아키텍처, 딥 리콜, 인터셉터, 드림 엔진에 대한 상세한 섹션이 포함되어 있습니다.
• 실제 예시 – README에는 에이전트가 자체 생성한 작업 기억을 보여주는 실제 MEMORY.md 스냅샷이 포함되어 있습니다.
• 커뮤니티 – 업데이트 및 토론을 위해 X(@Bitterbot_AI)에서 프로젝트를 팔로우하세요.

---

위 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.