[AI 활용팁] 브라우저·터미널 대신 사용해 주는 개인 에이전트 '오픈뮤즈' 사용하기

이 기사, AI에게 물어보기

에이전트 개발 도구를 개발하는 코파일럿킷(CopilotKit) 조직이 깃허브에 개인 에이전트 앱 ‘오픈뮤즈(OpenMuse)’를 공개했다. 이용자가 원하는 결과를 입력하면 에이전트가 계획을 세워 작업하고, 이용자는 진행 과정을 확인하다가 필요한 단계에서 검토하는 방식이다. 첫 공개 버전은 9월 15일 배포된 0.1.0 알파이며, MIT 라이선스로 소스를 공개했다. 하나의 코드로 아이폰과 안드로이드, 웹 화면을 모두 지원한다.

다만 저장소 설명에는 오픈뮤즈가 코파일럿킷의 공식 제품이 아니라고 적혀 있다. 코파일럿킷의 리액트 네이티브 도구와 AG-UI로 만든 템플릿에 가깝고, 이용자가 복제해 직접 수정하는 용도다. AG-UI는 에이전트와 앱 화면이 실시간으로 이벤트를 주고받는 통신 규약이다.

1. 오픈뮤즈의 주요 기능

오픈뮤즈는 에이전트마다 로그인 상태가 유지되는 크롬 기반 브라우저(크로미움)를 제공하고, 선택 사항으로 리눅스 작업 공간도 연결할 수 있다. 에이전트는 공개 웹페이지를 탐색하고 격리된 컨테이너에서 명령을 실행하며 파일을 다룬다. 이용자는 ‘제어 가져오기(Take control)’ 버튼으로 에이전트가 쓰던 브라우저 세션을 열어 직접 이어서 조작할 수 있다.

기능	알파 버전에서 지원하는 내용
채팅	메일 검색·읽기, 작업 위임, 이메일·브라우저·PDF·계획·재무 결과 화면
에이전트 컴퓨터	로그인이 유지되는 브라우저 프로필, 격리된 리눅스 터미널, 작업 공간 파일, PDF 전송
작업 현황	작업 계획과 진행률, 일시정지·재개·취소·재시도, 승인 요청과 실행 기록
목표·추적	목표와 마일스톤, 공개 웹페이지 변경·재고·달러 가격 기준 주기 확인과 알림
문서	메일 첨부 PDF에 값을 입력해 사본을 만들고 회신까지 검토
재무	거래 내역 CSV를 불러와 지출 요약과 저축 목표 생성
지메일·구글 캘린더	구글 OAuth 연동, 초안·첨부 작성, 일정 생성·수정·삭제(검토 후 실행)

메일 발송이나 일정 변경은 이용자가 검토 단계에서 승인해야 실행된다. 건강·금융·SNS 연동, 음성, 자동 결제와 예약은 로드맵에 올라 있으며 이번 알파에는 포함되지 않았다.

2. 설치 준비 조건

노드(Node) 24 LTS와 패키지 관리 도구 pnpm 11.19.0이 필요하다. 기본 로컬 실행에는 AI 모델 키나 구글 계정, 도커, 코파일럿킷 인텔리전스 구독이 없어도 된다. 이 상태에서는 앱에 포함된 가상 메일함과 예시 데이터로 기능을 확인할 수 있다.

3. 로컬 실행 순서

터미널에서 아래 명령을 순서대로 한 줄씩 입력한다. 먼저 저장소를 내려받는다.

git clone https://github.com/CopilotKit/OpenMuse.git openmuse

내려받은 폴더로 이동한다.

cd openmuse

앱 실행에 필요한 외부 라이브러리를 설치한다.

pnpm install --frozen-lockfile

설정 예시 파일을 복사해 환경 설정 파일(.env)을 생성한다.

cp .env.example .env

서버를 실행한다.

pnpm dev

서버를 켜 둔 상태에서 다른 터미널 창을 열고 웹 화면을 실행한다.

pnpm dev:web

브라우저에서 localhost:8081에 접속하면 앱 화면이 나타나고, API 상태는 localhost:8787/api/health에서 확인할 수 있다. 아이폰이나 안드로이드에서 실행하려면 Xcode나 안드로이드 개발 도구가 설치돼 있어야 한다. 아이폰은 아래 명령을 쓴다.

pnpm --dir apps/mobile ios

안드로이드는 아래 명령을 쓴다.

pnpm --dir apps/mobile android

4. 처음 시험해 볼 작업

저장소 안내문은 가상 데이터로 시험할 수 있는 예시 작업을 제시한다.

채팅에서 “Complete the permission slip”을 보내면 가상의 동의서 PDF에 값을 입력하고, 저장된 PDF와 준비된 회신을 검토할 수 있다. 결과는 로컬 메일함에만 기록된다.
‘목표 → 추적’ 메뉴에서 기본 제공 테스트 페이지를 감시 대상으로 등록한 뒤 페이지를 바꾸면 알림이 표시된다.
‘메뉴 → 작업 위임 → 재무’에서 예시 거래 내역을 선택하면 지출 추적 화면이 생성된다.

5. AI 모델과 구글 계정 연결

실제 모델로 에이전트를 작동하려면 .env 파일에 AGENT_BACKEND=model과 MODEL=제공사/모델명, 해당 제공사 API 키를 입력한다. 오픈AI와 앤트로픽, 구글 모델을 지원하며, API 키는 서버에만 저장된다.

개인 지메일과 캘린더를 연결하려면 WORKSPACE_MODE=live로 바꾸고, 24자 이상의 접근 키와 32바이트 암호화 키를 설정한 뒤 구글 클라우드에서 OAuth 웹 클라이언트를 생성해야 한다. OAuth는 비밀번호를 직접 넘기지 않고 권한을 위임하는 인증 방식이다. 저장소 안내에 따르면 구글 인증 정보는 암호화해 보관하며, 이 구성은 소유자 한 명이 쓰는 방식이라 여러 사용자를 나눠 관리하는 인증 시스템은 아니다.

6. 브라우저 작업과 리눅스 터미널 설정

에이전트가 웹을 탐색하게 하려면 브라우저 워커를 별도로 실행한다. .env에 워커 주소와 32자 이상의 토큰을 설정한 뒤, 에이전트가 쓸 크로미움 브라우저를 설치한다.

pnpm --dir apps/worker exec playwright install chromium

설치가 끝나면 브라우저 워커를 실행한다.

pnpm dev:browser

리눅스 터미널은 도커 이미지를 빌드한 뒤 COMPUTER_ENABLED=true 설정으로 켤 수 있다. 명령은 관리자 권한이 없는 컨테이너에서 실행되고, 한 번에 30초까지 수행되며, 터미널 자체의 네트워크 접속은 차단돼 있다. 저장소는 이 기능이 완전한 가상 머신이 아니라 리눅스 컨테이너라고 설명한다.

7. 알파 버전 제약과 라이선스

대화 기록을 여러 스레드로 나눠 저장하고 다시 불러오는 ‘리치 스레드’ 기능에는 코파일럿킷 인텔리전스 API 키가 필요하다. 이 인텔리전스 서비스는 별도 서비스로, 저장소의 MIT 라이선스에 포함되지 않으며 프로젝트 키도 함께 제공되지 않는다. 키를 설정하지 않으면 대화 하나를 로컬 데이터베이스에 저장하는 기본 방식으로 작동하므로, 앱을 실행하는 데 이 키가 반드시 필요한 것은 아니다.

그래픽 데스크톱 환경과 자동 결제는 아직 지원하지 않는다. 백그라운드 작업을 계속하려면 서버를 실행한 상태로 유지해야 하고, 브라우저 프로필과 문서가 저장되는 .openmuse 폴더는 외부에 공개하지 않도록 관리하는 편이 낫다.

오픈뮤즈는 아직 알파 버전이다. 가상 데이터로 먼저 실행해 보고, 실제 메일 계정은 검토 절차를 확인한 뒤 연결해 보자.

자세한 내용은 오픈뮤즈 깃허브 저장소에서 확인할 수 있다.

이미지 출처: 깃허브