OpenMuse 운영 중

OpenMuse는 CopilotKit이 오픈 소스로 공개한 개인 AI 비서입니다. OpenMuse는 Agent에 컴퓨터 한 대를 제공하며, 영구 브라우저, 선택 가능한 Linux 컨테이너와 파일 시스템을 지원합니다. 작업은 백그라운드에서 계속 실행할 수 있고 언제든 일시 중지하거나 직접 이어받을 수 있습니다. OpenMuse는 Gmail/캘린더, PDF 양식 작성, 웹 모니터링, 지출 분석 등을 지원합니다. iOS/Android/Web을 대상으로 하며, 모델과 API 키를 직접 설정해야 하므로 개발자의 2차 개발에 적합합니다.

WeChat에서 팔로우한 후 “오픈 소스”라고 답장하여 AI 오픈 소스 프로젝트 교류 그룹에 가입하세요.
채팅 상호작용: CopilotKit 헤드리스 채팅과 AG-UI 이벤트 스트리밍 응답을 지원합니다. 이메일 검색, 전송/중지를 통합한 입력창을 제공하며 이메일, 브라우저, PDF 결과를 인라인 카드로 표시합니다.
Agent 컴퓨터: 영구 Chromium 브라우저와 선택 가능한 Linux Docker 컨테이너가 내장되어 있어 Agent가 웹을 탐색하고 명령을 실행하며 파일과 PDF를 처리할 수 있습니다.
사용자 직접 제어: 언제든 브라우저나 터미널을 열어 Agent의 실시간 작업을 확인하고, “Take control”을 눌러 같은 세션을 직접 이어서 작업할 수 있습니다.
작업 관리: 작업에 계획, 진행 상황, 승인 단계가 포함되며 일시 중지, 재개, 취소, 재시도를 지원합니다. 프런트엔드를 닫아도 작업은 서버에서 계속 실행됩니다.
문서 처리: 이메일 첨부 PDF를 읽고, 필요한 양식 필드를 추가로 요청하며, 작성된 사본을 생성해 검토할 수 있도록 준비하고 답장 초안도 작성합니다.
Gmail 및 캘린더: Google OAuth로 연결하며, 전체 이메일 스레드, 초안, 캘린더 이벤트의 생성/수정/삭제를 지원합니다. 모든 쓰기 작업에는 사용자 확인이 필요합니다.
목표 추적: 목표를 마일스톤으로 나눌 수 있으며, 공개 웹 페이지의 콘텐츠 변경, 재입고 여부, 가격 임계값을 정기적으로 확인할 수 있습니다. 알림은 자동으로 중복 제거됩니다.
지출 분석: 거래 CSV를 가져오면 분류별 요약과 저축 목표 제안을 자동으로 생성합니다.
개인 기억: 이름, 말투, 아바타, 기억 선호도를 편집할 수 있으며 작업 간에 지속적으로 유지됩니다.

프로젝트를 로컬에 복제합니다: 터미널에서 git clone https://github.com/CopilotKit/OpenMuse.git openmuse를 실행한 다음 cd openmuse를 실행해 프로젝트 디렉터리로 이동합니다.
프로젝트 의존성을 설치합니다: 프로젝트 루트에서 pnpm install --frozen-lockfile을 실행해 lock 파일에 지정된 모든 의존성을 설치합니다.
환경 변수 파일을 생성합니다: cp .env.example .env를 실행해 예시 설정을 실제 환경 변수 파일로 복사합니다.
로그인하고 CopilotKit 프로젝트를 선택합니다: npx copilotkit@latest login을 실행해 로그인한 다음 npx copilotkit@latest project select를 실행해 Intelligence 프로젝트를 선택하거나 생성합니다.
Intelligence 키를 입력합니다: 로그인 후 생성된 CPK_INTELLIGENCE_API_KEY를 .env 파일에 복사합니다. 이 키는 대화 지속성 기능에 필수입니다.
백엔드 API 서비스를 시작합니다: pnpm dev를 실행해 API 서비스를 시작합니다. 시작 후 localhost:8787/api/health에서 상태를 확인할 수 있습니다.
Web 프런트엔드를 시작합니다: 별도의 터미널에서 pnpm dev:web을 실행한 다음 브라우저에서 localhost:8081에 접속해 애플리케이션을 엽니다.
내장 기능을 체험합니다: 채팅 창에 “Complete the permission slip”을 입력해 PDF 양식 작성 과정을 체험할 수 있습니다. 또는 Goals → Track에서 웹 모니터링 작업을 생성해 알림을 테스트할 수 있습니다.
실제 모델을 설정합니다: .env에 AGENT_BACKEND=model, MODEL=provider/model-id를 설정하고 선택한 제공업체(OpenAI, Anthropic 또는 Google)의 API 키를 입력합니다.
Gmail과 캘린더를 연결합니다: Google Cloud Platform에서 OAuth 클라이언트를 생성하고 Gmail 및 Calendar API를 활성화합니다. Client ID와 Secret을 .env에 입력한 다음 애플리케이션의 Apps 페이지에서 계정 인증을 완료합니다.
브라우저 작업 스레드를 시작합니다: 먼저 pnpm --dir apps/worker exec playwright install chromium을 실행해 브라우저를 설치한 다음 pnpm dev:browser를 실행해 브라우저 서비스를 시작합니다.
Linux 작업 공간을 활성화합니다: docker build -t openmuse-computer:local apps/computer를 실행해 컨테이너 이미지를 빌드한 다음 COMPUTER_ENABLED=true pnpm dev를 실행해 API에서 작업 공간을 활성화합니다.
모바일 앱을 실행합니다: iOS 기기에서는 pnpm --dir apps/mobile ios를, Android 기기에서는 pnpm --dir apps/mobile android를 실행합니다. 로컬에 Xcode 또는 Android 툴체인이 설치되어 있어야 합니다.

실제 Agent 작업 공간: 영구 브라우저와 선택 가능한 Linux 컨테이너가 내장되어 있어 Agent가 실제로 웹을 탐색하고 명령을 실행하며 파일을 처리할 수 있습니다.
전 과정의 가시성과 제어: 사용자는 언제든 브라우저나 터미널을 열어 Agent의 작업을 확인하고 즉시 세션을 직접 이어서 작업할 수 있습니다.
중단 없는 백그라운드 작업: 작업 계획, 진행 상황, 실행 기록이 지속적으로 저장됩니다. 프런트엔드를 닫아도 서버에서 계속 실행되며 중단 후에도 재개할 수 있습니다.
명확한 보안 경계: 이메일 전송, 캘린더 수정 등의 쓰기 작업에는 모두 사용자 확인이 필요합니다. 자격 증명은 암호화되어 저장되며 숨겨진 자동 재시도는 없습니다.
하나의 코드로 여러 플랫폼 지원: CopilotKit React Native를 기반으로 iOS, Android, Web을 모두 지원합니다.
분리되고 교체 가능한 아키텍처: AG-UI 프로토콜로 프런트엔드와 백엔드를 연결하며, Agent 백엔드는 호환되는 모든 harness로 교체할 수 있습니다.
바로 사용할 수 있는 통합 기능: 이메일, 캘린더, PDF 양식, 웹 모니터링, 지출 분석 등 개인 비서의 일반적인 사용 사례가 완성도 있게 연결되어 있습니다.

GitHub 저장소: https://github.com/CopilotKit/openmuse

이메일 업무 처리: 비서가 자동으로 이메일을 검색하고 관련 이메일을 연 다음, 첨부된 PDF를 읽고 필요한 정보를 추가로 요청합니다. 양식 사본을 작성하고 답장 초안을 준비한 뒤 한 번의 확인으로 전송할 수 있도록 대기합니다.
웹 조사 및 정보 수집: Hacker News를 탐색하거나 특정 주제를 조사할 수 있습니다. 브라우저와 요약 결과가 채팅에 바로 인라인으로 표시되며, 언제든 Take control로 개입해 방향을 수정할 수 있습니다.
가격 및 재고 모니터링: 목표를 설정하면 상품 페이지를 정기적으로 확인하고, 재입고되거나 USD 가격이 임계값 아래로 내려갈 때 자동으로 알림을 보냅니다. 구매 경쟁과 가격 비교에 적합합니다.
일정 및 행사 관리: Gmail/캘린더 OAuth를 연결해 이메일에 포함된 행사 정보를 확인하고 캘린더 이벤트를 생성하거나 수정할 수 있습니다. 모든 변경 사항은 사용자의 확인을 거칩니다.
개인 재무 관리: 은행 거래 CSV를 가져오면 분류별 지출 요약과 저축 목표 제안을 자동으로 생성해 대화형 가계부 대시보드로 관리할 수 있습니다.