| 한눈에 보기 | |
|---|---|
| 저장소 | Anil-matcha/open-duet |
| 개발 | Anil-matcha (개인) |
| GitHub 스타 | 6,108 (오늘 +68) |
| GitHub 트렌딩 | 일간 Python 11위 |
| 포크 | 758 |
| 주 언어 | Python |
| 라이선스 | Apache-2.0 |
| 공개일 | 2023-05-25 |
Anil-matcha/open-duet는 AI 에이전트를 '동료'처럼 다루는 오픈소스 워크스페이스다. 에이전트마다 이름과 역할, 지시문, 모델, 작업 폴더, 메모리, 승인 방식을 정해 두고 대화하며 일을 맡긴다. 개인 개발자 Anil-matcha가 만들었고, 클로드 듀엣(Claude Duet)을 비롯해 오픈AI(OpenAI)·메타·xAI·마누스(Manus)의 유사 서비스를 대체하는 셀프호스팅 대안을 내세워 GitHub 트렌딩 일간 Python 11위에 올랐다.
무엇을 하나: 에이전트 명단과 팀 위임
- 에이전트 명단 구성: 리서치, 기획, 글쓰기, 지원, 개발 등 용도별로 에이전트를 만든다.
- 팀 작업: 리드 에이전트와 전문 에이전트를 지정하면 리드가 작업을 나눠 맡기고, 결과는 채팅에서 확인한다. 공유 룸에 여러 에이전트를 모을 수도 있다. 다만 현재 팀 리드는 클로드(Claude) 엔진을 써야 한다.
- 메모리: 에이전트가 노트를 남기고 이전 대화를 검색한다. 사용자가 기억 내용을 검토하고 고칠 수 있다.
- 루틴: 일정, 웹훅, 수동 실행(Run now)으로 작업을 돌린다. 루틴이 스스로 승인하는 일은 없다고 README는 밝힌다.
- 통제 장치: 'Ask first', 'Accept edits', 'Plan only' 중에서 자율성을 고르고 도구 사용·승인 기록을 앱에서 본다. 격리된 도커(Docker) 컴퓨터와 브라우저 접근은 실험 기능이며 기본은 꺼져 있다.
작동 방식·구조
Open Duet 자체에는 모델이나 구독이 없다. 앱은 대화, 에이전트 노트, 루틴, 설정을 로컬 데이터 폴더나 서버 DB에 저장하고, 작업 파일은 에이전트에 지정한 폴더에 둔다. 앱에 저장한 API 키는 암호화된다고 한다.
답변이 필요할 때는 선택한 '엔진'에 해당 턴의 프롬프트와 첨부 텍스트, 관련 노트, 엔진이 읽은 작업 폴더 내용이 전달된다. 엔진이 호스팅 서비스라면 그 제공사의 약관이 적용된다. 지원 엔진은 클로드 코드(Claude Code), 코덱스(Codex) CLI, 제미나이(Gemini) CLI, 커서(Cursor), ACP(Agent Client Protocol) 기반 CLI 에이전트, 오픈라우터(OpenRouter), 올라마(Ollama)·LM 스튜디오 같은 OpenAI 호환 API다. 엔진별로 이미지 입력이나 에이전트 컴퓨터 지원 여부가 다르다.
써보면
데스크톱 앱은 소스 체크아웃으로 실행한다. Node.js 22 이상, uv, 같은 컴퓨터의 엔진 하나가 필요하다. CLI 엔진은 먼저 설치하고 로그인해 둔다.
git clone https://github.com/Anil-matcha/open-duet.git
cd open-duet/desktop
npm run app
첫 실행 때 설정 화면이 엔진을 점검하고 작업 폴더와 승인 모드를 고르게 하며 시작용 에이전트도 만들어 준다. 이후 Settings → Engines에서 엔진 상태를 확인하고, 이름·역할·작업 폴더를 정해 에이전트를 만든 뒤 채팅을 시작한다. 승인이 필요하면 Ask first를 고른다. 일반 채팅에는 도커가 필요 없다.
예를 들어 리드 에이전트(엔진: Claude)와 리서처·편집자를 같은 프로젝트 폴더에 연결해 주간 브리핑을 요청하면, 리드가 작업을 쪼개 맡기고 결과를 모아 브리핑을 만든다. 쓸 만해지면 주간 루틴으로 등록하는 식이다.
누구에게 유용한가
여러 CLI 에이전트를 한 화면에서 역할별로 나눠 쓰고 싶은 개발자, 보고서·리서치처럼 반복 업무를 루틴으로 돌리고 싶은 1인 사업자나 소규모 팀에 맞다. 내 서버에 올려 PC가 꺼져 있어도 에이전트와 루틴을 유지하려는 사용자도 대상이다. 데이터를 직접 보관하면서 엔진은 올라마 같은 로컬 모델로 바꿀 수 있다는 점도 장점이다.
의의와 한계
라이선스는 Apache-2.0이다. 저장소는 2023년 5월에 생성됐고 최근 커밋은 2026년 10월 23일이지만 공식 릴리스는 없다. README는 활발히 개발 중이라고 밝히며 한계를 직접 적는다.
- 서버 구성은 실험 단계이며 한 명의 소유자와 페어링된 기기용이다. 조직용 다중 사용자 워크스페이스가 아니다.
- 팀 위임은 새 기능이고 리드는 현재 Claude 필수다.
- 도커 컴퓨터, 브라우저 도구, macOS 네이티브 미리보기는 실험적이다.
- 데스크톱 설치 파일은 서명되지 않았고 자동 업데이트도 없다. 문서상 권장 경로는 소스 체크아웃이다.
- 지메일·슬랙·노션 같은 내장 연동 카탈로그는 아직 없다.
- 모델 접근은 제공하지 않으므로 계정과 사용 비용은 사용자 몫이다.
중요한 업무에 쓰기 전에 이런 제약을 확인할 필요가 있다.
