⚡ PC에게 무엇을 할지 알려주세요. Capri는 Claude Code, Codex 또는 Antigravity를 통해 파일, 프로젝트 및 코드를 다루는 사이버펑크 AI 에이전트입니다. Windows 설치 프로그램이며 터미널이 필요 없습니다. 팬 제작 작품으로, CD PROJEKT RED와는 관련이 없습니다.
<div align="center">
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/banner.svg" alt="Capri: cyberpunk AI agent for your Windows desktop" width="100%"/>
<br/>
<a href="https://github.com/boardshogunfluctuate/capri-ai/releases/latest">
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/download-button.svg" alt="Download Capri for Windows" width="360"/>
</a>
<br/><br/>
Release
Stars
License
Platform
<sub>Windows 설치 프로그램(.exe) · Windows 10 이상</sub>
<br/>
기능 · 빠른 시작 · 질문할 수 있는 내용 · 작동 방식 · 안전성 · 로드맵 · FAQ
</div>
<br/>
공식적이지 않은 팬 프로젝트로, 사이버펑크 세계관과 Cyberpunk: Edgerunners에서 영감을 받았습니다. CD PROJEKT RED, Netflix, Studio Trigger, Anthropic, OpenAI 또는 Google과는 제휴하거나 보증하지 않습니다. 모든 제품명은 각 소유자에게 속합니다.
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
Capri란 무엇인가
> capri --boot
[ OK ] engine router .......... claude-code · codex · antigravity
...
Capri는 사용자의 Windows 데스크톱에 존재하는 사이버펑크 AI 에이전트입니다. 마치 자신만의 JARVIS 스타일 비서처럼 생각하시면 됩니다. 평범한 언어로 원하는 것을 설명하면, Capri가 단계를 계획하고, 적절한 도구를 사용하며, PC에서 작업을 완료합니다. 터미널은 필요하지 않습니다.
내부적으로 Capri는 사용자가 이미 사용하는 AI 비서 위에 구축된 데스크톱 인터페이스이자 에이전트 계층입니다. 이는 Claude Code, Codex, Antigravity 및 기타 AI 비서와 작동하므로, 사용자는 두뇌(지능)를 선택하고 Capri가 몸체 역할을 합니다.
사양표 (Spec sheet)
| |
|---|
| 엔진 (Engines) | Claude Code · Codex · Antigravity · 사용자 지정 어댑터 (custom adapters) |
| ... | |
| --> | |
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
주요 기능 (Features)
<table>
<tr>
<td width="33%" valign="top">
<b>🧠 모든 두뇌 연결</b><br/><br/>
Claude Code, Codex, Antigravity 또는 다른 비서를 연결하고 언제든지 전환할 수 있습니다.
</td>
<td width="33%" valign="top">
<b>🖥️ 데스크톱 네이티브</b><br/><br/>
터미널에 살고 싶지 않은 사람들을 위해 구축된 깨끗한 인터페이스를 가진 실제 Windows 앱입니다.
</td>
<td width="33%" valign="top">
<b>📂 파일 및 프로젝트</b><br/><br/>
단 한 문장으로 파일과 전체 프로젝트 폴더를 찾고, 읽고, 정리하고 편집할 수 있습니다.
</td>
</tr>
<tr>
<td width="33%" valign="top">
<b>⚙️ 완전한 에이전트 툴킷</b><br/><br/>
Capri는 작업을 계획하고, 도구를 사용하며, 결과를 확인하고 보고합니다. 단순한 채팅 창이 아닙니다.
</td>
<td width="33%" valign="top">
<b>💻 온디맨드 코드 (Code on demand)</b><br/><br/>
선호하는 엔진을 통해 코드를 작성하고, 리팩터링하고, 디버깅하고, 실행할 수 있습니다.
</td>
<td width="33%" valign="top">
<b>🛡️ 사용자가 통제권을 가짐</b><br/><br/>
Capri가 무엇을 하려는지 검토하고, 파일에 영향을 주기 전에 승인하거나 거부할 수 있습니다.
</td>
</tr>
</table>
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
빠른 시작 (Quick start)
1. 다운로드
현재 Capri는 설치 프로그램 형태로 Windows에서 이용 가능합니다:
2. 설치 및 실행
Capri-Setup.exe를 실행하고 마법사(wizard)의 지침을 따릅니다. 그런 다음 시작 메뉴에서 Capri를 열어 사용합니다.
<details>
<summary><b>Windows가 SmartScreen 경고를 표시하는 경우?</b></summary>
<br/>
아직 널리 다운로드되지 않은 새 앱은 SmartScreen 프롬프트를 발생시킬 수 있습니다. 이 저장소의 릴리스(Releases) 페이지에서 Capri를 다운로드했다면, 추가 정보 → 그래도 실행을 클릭하십시오.
</details>
3. AI 연결하기
Capri는 첫 실행 시 어떤 어시스턴트를 사용할지 묻습니다. 계정에 로그인하거나 Claude Code, Codex, Antigravity 또는 지원되는 다른 어시스턴트의 API 키를 붙여넣으십시오.
요청할 수 있는 것들
| 사용자가 말하는 내용 | Capri가 수행하는 작업 |
|---|
| "다운로드 폴더를 정리하고 모든 것을 유형별로 그룹화해 줘." | 폴더를 스캔하고 계획을 제안한 후 승인에 따라 파일을 이동합니다. |
| ... | |
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
작동 방식
flowchart LR
U([사용자]) -->|일상 언어(plain language)| C[Capri 데스크톱]
C --> R{엔진 라우터}
...
- 사용자가 목표를 일상 언어로 설명합니다.
- Capri가 사용자가 선택한 AI 엔진으로 경로를 지정합니다.
- 엔진이 단계를 계획하고 Capri에게 도구 사용을 요청합니다.
- 사용자가 민감한 작업을 승인하면, Capri가 데스크톱에서 이를 수행합니다.
지원되는 엔진
설정 (Configuration)
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
안전성 (Safety)
데스크톱에서 작동하는 에이전트는 강력하므로, 주의해서 다루어야 합니다:
⚠️ 승인 전 검토하세요. Capri가 수행하려는 작업, 특히 파일을 삭제하거나 이동하거나 덮어쓰는 작업에 대해 주의 깊게 읽어보세요.
- 범위를 제한하세요. Capri가 필요한 폴더에만 접근 권한을 부여하세요.
- 백업을 유지하세요. 대규모 자동화 작업을 실행하기 전에 중요한 데이터를 백업하세요.
- 키를 보호하세요. API 키나 계정 토큰을 누구와도 공유하지 마세요.
보안 문제를 발견했습니까? SECURITY.md를 읽고 비공개로 신고해 주세요.
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
사이버펑크: 에지러너스(Cyberpunk: Edgerunners)에서 영감을 받다
Capri는 기술에 날카로운 감각을 좋아하는 사람들을 위해 구축되었습니다. 이 프로젝트는 사이버펑크(cyberpunk) 장르와, 시즌 2에서 등장하는 'Capri'라는 신비한 AI 구조물로부터 그 외관과 정신적 영감을 얻었습니다.
- 🌃 사이버펑크 미학: 거의 검은색 바탕에 네온 노란색, 시안(cyan), 빨간색을 사용하며, 위험 경고 줄무늬와 글리치 디테일이 특징입니다.
- 🧑💻 넷러너 에너지: 당신이 명령을 내리면, AI 오퍼레이터가 나머지 작업을 처리합니다.
- 🔴 에지러너 태도: 빠르고, 독립적이며, 당신의 편입니다.
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
로드맵
아이디어가 있나요? 기능 요청을 열어 Capri가 다음에 무엇을 학습해야 할지 알려주세요.
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
자주 묻는 질문 (FAQ)
<details>
<summary><b id="faq1">Capri가 무료인가요?</b></summary>
<br/>
Capri는 오픈 소스(open source)입니다. 사용자가 자신의 AI 어시스턴트 계정이나 API 키를 사용하므로, AI 제공업체에서 발생하는 모든 비용은 해당 제공업체에 청구됩니다.
</details>
<details>
<summary><b id="faq2">Capri가 macOS 또는 Linux에서 작동하나요?</b></summary>
<br/>
아직 아닙니다. 현재 Capri는 설치 파일(.exe) 형태로 Windows에서 사용할 수 있습니다. macOS 및 Linux 버전은 계획 중이므로, 진행 상황을 확인하려면 레포지토리(repo)를 별표 표시해 주세요.
<details>
<summary><b>코딩을 알아야 하나요?</b></summary>
<br/>
아니요. 앱을 다운로드하고, 연결할 AI를 지정한 후, 필요한 내용을 평이한 언어(plain language)로 설명하기만 하면 됩니다.
</details>
<details>
<summary><b>Capri는 어떤 AI 비서들을 지원하나요?</b></summary>
<br/>
Claude Code, Codex, Antigravity가 기본적으로(out of the box) 지원되며, 커스텀 어댑터(custom adapters)를 통해 다른 비서들도 연결할 수 있습니다.
</details>
<details>
<summary><b>AI가 제 데스크톱을 제어하는 것이 안전한가요?</b></summary>
<br/>
Capri는 실행되기 전에 사용자가 행동을 검토할 수 있도록 설계되었지만, 어떤 도구도 위험이 없는 것은 아닙니다. 폴더 접근 권한을 제한하고, 백업을 유지하며, Safety 섹션을 읽어보세요.
</details>
<details>
<summary><b>제 데이터는 어디로 가나요?</b></summary>
<br/>
사용자의 요청은 연결하는 AI 비서에 의해 처리되며, 이는 해당 제공업체(provider)의 이용 약관 및 개인정보 보호 정책을 따릅니다.
</details>
<details>
<summary><b>Capri는 공식 사이버펑크 또는 에지러너스 제품인가요?</b></summary>
<br/>
아닙니다. Capri는 Cyberpunk: Edgerunners에서 영감을 받은 사이버펑크 미학을 가진 독립적이고 비공식적인 팬 프로젝트입니다. CD PROJEKT RED, Studio Trigger, Netflix 또는 다른 어떤 권리 보유자(rights holder)와도 제휴하거나 승인받지 않았습니다.
</details>
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
기여(Contributing)
모든 형태의 기여를 환영합니다: 버그 보고, 기능 아이디어, 테마, 엔진 어댑터 및 문서화. 시작하려면 CONTRIBUTING.md를 읽고, 버그를 보고하거나 기능을 제안하려면 이슈 양식(issue forms)을 사용하세요.
라이선스(License)
MIT License에 따라 배포되었습니다.
<img src="https://raw.githubusercontent.com/boardshogunfluctuate/Capri-AI/HEAD/assets/divider.svg" alt="" width="100%"/>
<div align="center">
Capri가 시간을 절약해 드렸다면, 별점(⭐)을 남기고 친구와 공유해주세요.
날카롭게 지내세요, 에지러너(edgerunner).