<div align="center">
CAPRI
나이트 시티를 위해 제작되었으며 PC에서 실행되는, 당신의 개인 데스크톱 AI 에이전트.
로컬 우선(local-first)의 데스크톱 에이전트로 사이버펑크 감성을 담았습니다. Capri는 사용자의 기기에 상주하며 의도를 이해하고 파일, 앱, 브라우저, 터미널, 코드 등 다양한 작업을 실행합니다. Claude Code, Codex, Antigravity 또는 기타 모든 모델 백엔드를 연결하여 작동시킬 수 있습니다.
<br/>
Release
Stars
Platform
Build
License
윈도우 다운로드 | 기능(Features) | 아키텍처(Architecture) | 로드맵(Roadmap) | 자주 묻는 질문(FAQ)
</div>
Capri란 무엇인가
Capri는 Cyberpunk: Edgerunners의 미학과 아이디어에서 영감을 받은 오픈 데스크톱 AI 에이전트입니다. 이는 브라우저 탭에 머무르는 것이 아니라, 사용자의 기기 자체에 상주하는 빠르고 날카로우며 항상 작동하는 네트러너(netrunner) 비서 역할을 합니다.
대부분의 AI 도구는 채팅 창에서 멈춥니다. 하지만 Capri는 그 이상을 수행합니다. 이는 **네이티브 데스크톱 셸을 갖춘 에이전트 런타임(agent runtime)**입니다. 자연어 형태의 목표를 받으면, 필요한 단계를 계획하고 시스템의 도구를 호출하며, 결과를 관찰하고, 작업이 완료될 때까지 반복(iterate)합니다. 마치 자신만의 Jarvis와 같지만, 네온 HUD와 훨씬 더 좋은 사운드트랙을 갖춘 느낌이라고 생각하시면 됩니다.
Capri는 모델에 구애받지 않습니다(model-agnostic). 사용자가 이미 사용하는 Claude Code, Codex, Antigravity 같은 코딩 및 추론 에이전트를 하나의 통합 인터페이스 뒤에 래핑하여, 몸체는 바꾸지 않고도 두뇌만 바꿀 수 있게 해줍니다.
기능(Features)
에이전트 핵심 (Agent core)
| 역량 (Capability) | 설명 (Description) |
|---|
| 자연어에서 액션으로 | 원하는 결과를 설명하면, Capri가 이를 도구 호출 계획으로 분해하여 단계별로 실행합니다. |
| ... | |
기능 목록
| 기능 | 설명 |
|---|
| 파일 작업(File operations) | 자연어(natural language)를 사용하여 파일과 폴더를 검색, 읽기, 생성, 이동, 이름 변경 및 일괄 처리할 수 있습니다. |
| ... | |
개발자 모드 (Developer mode)
| 기능 | 설명 |
|---|
| 코드 에이전트 통합(Code agent integration) | 리팩토링(refactor), 버그 탐지(bug hunt), 테스트 생성 및 저장소 분석을 연결된 코딩 백엔드에 위임합니다. |
| ... | |
인터페이스 (Interface)
- 네온 HUD 오버레이(Neon HUD overlay). 전역 단축키로 호출되는 가벼운 항상 최상단 패널입니다.
- 명령어 팔레트(Command palette). 도구, 기록 및 저장된 워크플로우에 대한 퍼지 검색(fuzzy search)을 지원하는 키보드 우선 입력 방식입니다.
- 음성 입력(Voice input). 손을 사용하지 않고 명령할 수 있도록 푸시 투 토크 받아쓰기 기능을 제공합니다.
- 테마(Themes). 조정 가능한 글로우, 스캔라인 및 글리치 강도를 가진 내장 사이버펑크 테마와 깔끔한 미니멀 모드를 제공합니다.
- 트레이 모드(Tray mode). 낮은 유휴 자원 사용률로 시스템 트레이에서 조용히 실행됩니다.
아키텍처 (Architecture)
+--------------------------------------+
| Capri Desktop |
| HUD 오버레이 | 팔레트 | 트레이 | 음성|
...
설계 원칙 (Design principles)
- 로컬 우선(Local-first). 파일, 메모리 및 로그는 기기에 유지됩니다. 전송하는 프롬프트와 컨텍스트만 외부로 나갈 수 있으며, 이는 설정한 백엔드로만 제한됩니다.
- 어댑터 패턴(Adapter pattern). 모든 모델 백엔드는 작고 타입이 지정된 인터페이스를 구현하므로, 새로운 제공업체 추가는 하나의 어댑터를 작성하는 문제에 불과합니다.
- 루프 내 인간(Human in the loop). 파괴적이거나 되돌릴 수 없는 작업은 명시적인 승인이 필요한 구성 가능한 정책 계층을 통과합니다.
- 기본적으로 관찰 가능(Observable by default). 모든 계획, 도구 호출 및 결과는 구조화되고 검사 가능한 세션 로그에 기록됩니다.
설치 (Installation)
현재 지원 플랫폼: Windows 10 및 Windows 11 (x64).
현재 배포판: 휴대용 ZIP 빌드. 아직 설치 프로그램은 없습니다.
Capri는 자체 포함형 휴대용 아카이브 형태로 제공됩니다. 설치 과정, 레지스트리 변경, 관리자 권한이 필요하지 않습니다.
- 최신 릴리스를 엽니다.
Capri-portable-x.y.z.zip을 다운로드합니다.
- 아카이브를 원하는 폴더(예:
D:\Apps\Capri)에 압축 해제합니다.
Capri.exe를 실행합니다.
처음 실행 시, Capri가 백엔드 연결 과정을 안내해 줍니다.
빌드가 포터블(portable)하기 때문에 보조 드라이브나 USB 스틱에 보관할 수 있습니다. 모든 설정, 메모리 및 로그는 실행 파일 옆에 저장되므로, Capri를 이동하거나 백업하는 것은 폴더 하나만 복사하면 됩니다.
업데이트. 새 ZIP 파일을 다운로드하여 기존 폴더 위에 덮어쓰기(extract over) 합니다. config.json, memory, tools 디렉토리는 보존됩니다.
Windows SmartScreen 참고 사항. 새로운 릴리스는 아직 신뢰도가 확립되지 않았을 수 있어 Windows에서 SmartScreen 프롬프트가 나타날 수 있습니다. 이 저장소의 Releases 페이지에서 아카이브를 다운로드했다면, **추가 정보(More info)**를 선택한 다음 **그래도 실행(Run anyway)**을 선택하세요.
빠른 시작 (Quick start)
1. 백엔드 연결하기 (Connect a backend)
**설정(Settings) > 백엔드(Backends)**를 열고 Capri에 동력을 공급할 에이전트를 선택합니다:
| 백엔드 | 설정 방법 |
|---|
| Claude Code | Anthropic 계정으로 로그인하거나 API 키 제공 |
| ... | |
2. Capri 소환하기 (Summon Capri)
전역 단축키(기본값 Ctrl + Alt + Space)를 눌러 어디서든 HUD를 엽니다.
3. 작업 부여하기 (Give it a job)
파일 유형별로 다운로드 폴더를 정리하고, 설치 프로그램은 /Installers로 이동시키고, 30일이 지난 중복 파일은 삭제해줘.
D:\dev\netrunner 프로젝트를 열어, /auth의 테스트가 실패하는 이유를 찾고 수정 방안을 제안해줘.
매일 아침 9시에 대시보드를 열어서 어제 수치를 가져와 메모에 넣어줘.
Capri는 먼저 계획(plan)을 보여줍니다. 이를 승인하거나, 수정하거나, 신뢰할 수 있는 작업 유형의 경우 자율 모드(autonomous mode)로 실행하도록 할 수 있습니다.
설정 (Configuration)
Capri는 Capri.exe 옆에 위치한 config.json에서 설정을 읽어옵니다. 모든 내용은 설정 UI에서도 확인할 수 있습니다.
{
"backend": "claude-code",
"hotkey": "Ctrl+Alt+Space",
...
}
{
"name": "check_gpu_temp",
"description": "Returns the current GPU temperature in Celsius"
...
파일을 Capri.exe 옆의 tools\ 폴더에 넣고 Capri를 재시작하세요. 에이전트가 자동으로 이를 발견합니다.
보안 및 개인 정보 보호 (Security and privacy)
- 범위 제한 접근(Scoped access). Capri는 사용자가 명시적으로 허용한 디렉터리만 건드릴 수 있습니다.
- 승인 게이트(Approval gates). 삭제, 셸 실행(shell execution), 푸시 및 업로드는 정책에 의해 통제됩니다.
- 감사 로그(Audit log). 모든 작업은 로컬의 추가 전용 세션 로그(append-only session log)에 기록됩니다.
- 기본적으로 원격 측정 기능 없음(No telemetry by default). 사용자가 옵트인하지 않는 한, Capri는 사용 분석 데이터를 수집하지 않습니다.
- 비밀 정보는 로컬에 보관됩니다(Secrets stay local). API 키와 토큰은 평문이 아닌 Windows 자격 증명 관리자(Windows Credential Manager)에 저장됩니다.
취약점을 발견했나요? 공개 이슈 대신 비공개 보안 권고(private security advisory)를 열어주세요.
로드맵 (Roadmap)
아이디어가 있나요? 기능 요청(feature request)을 열어주세요.
FAQ
Capri는 무료인가요?
Capri 자체는 무료 오픈 소스입니다. 선택한 백엔드는 별도의 구독 또는 API 키가 필요할 수 있습니다.
오프라인에서도 작동하나요?
데스크톱 셸, 도구 및 메모리는 오프라인에서 작동합니다. 추론(Reasoning)은 Capri를 로컬 모델 엔드포인트에 연결하지 않는 한, 연결된 백엔드가 필요합니다.
이것이 쇼에 나온 Capri인가요?
아닙니다. Capri는 사이버펑크 장르와 Edgerunners 세계관의 분위기를 차용한 오리지널 프로젝트입니다. 이 시리즈와 공식적인 관련은 없습니다.
나만의 모델을 사용할 수 있나요?
네, 백엔드 어댑터 인터페이스를 구현하거나 Capri를 모든 호환 가능한 엔드포인트에 연결할 수 있습니다.
macOS와 Linux도 지원하나요?
로드맵에 포함되어 있습니다. 윈도우가 먼저 나옵니다.
기여 (Contributing)
풀 리퀘스트(Pull request)는 환영합니다. 주요 변경 사항의 경우, 디자인을 논의할 수 있도록 먼저 이슈를 생성해 주세요.
- 저장소 포크(Fork)하기
- 브랜치 생성:
git checkout -b feature/your-feature
- 변경 사항 커밋(Commit)하기
- 푸시하고 풀 리퀘스트 열기
Capri가 시간을 절약해 드렸다면, 스타(star)를 눌러 다른 사람들이 이 프로젝트를 찾도록 도와주세요. 버그 보고, 아이디어 및 피드백은 Issues에서 확인하실 수 있습니다.
라이선스 (License)
MIT 라이선스(MIT License) 하에 배포됩니다. 자세한 내용은 LICENSE를 참조하세요.
면책 조항 (Disclaimer)
Capri는 사이버펑크 장르와 Cyberpunk: Edgerunners 유니버스에서 영감을 받은 독립적인 커뮤니티 프로젝트입니다. 모든 상표, 시리즈 이름 및 관련 속성은 각 소유자에게 속합니다. 어떠한 제휴나 보증도 암시되지 않습니다.
<div align="center">
정신 차려라, 사무라이. 우리가 돌릴 데스크톱이 있다.
</div>