채팅, 이미지 및 비디오, 음성, 그리고 에이전트 코딩 모듈까지 — 하나의 허브 뒤에 통합되었습니다.
사용자 키 지참. 텔레메트리 없음. 오픈 소스.
⬇️ 다운로드
·
🌐 웹사이트
·
📖 사용자 가이드
·
☕ 지원
Caelo는 xAI Grok, Google Gemini / Vertex AI 및 OpenAI GPT를 위한 독립적인 오픈 소스 데스크톱 클라이언트입니다. 다섯 개의 개별 도구 대신, 세 가지 제공업체를 하나의 공유 백본 뒤에 배치합니다 — 모든 모드에서 컨텍스트, 기록, 프로젝트 및 비용 흐름을 아우릅니다:
💬 채팅 · 🎨 이미지 & 비디오 · 🎙️ 음성 · ⌨️ 에이전트 코더 · 🧩 확장 기능
이는 사용자 자체 자격 증명 지참(bring-your-own-credentials) 방식입니다: xAI OAuth/API 키, Google Cloud ADC 또는 AI Studio 키, 그리고/또는 OpenAI API 키를 사용합니다. ChatGPT 구독은 OpenAI API를 인증하거나 비용을 충당하지 않습니다. 저장된 키와 xAI 토큰은 운영 체제(DPAPI/Keychain/Secret Service)에 의해 암호화되며, 사이드카 메모리로만 복호화되고 요청은 선택한 제공업체로만 전송됩니다. Caelo 계정 없음, 중간 관리자 없음, 텔레메트리 없음.
🔑 사용자 자체 자격 증명 지참 | xAI OAuth/API 키, Google Cloud ADC/AI Studio 키 또는 OpenAI API 키를 사용합니다. 저장된 비밀 정보는 Electron safeStorage를 사용하며, 설정 JSON에 절대 기록되지 않으며 UI로 반환되지 않습니다. |
🛡️ 설계상 프라이빗(Private by design) | 백엔드는 127.0.0.1에만 바인딩되며, 모든 요청은 토큰 인증을 거치고 키는 렌더러에 절대 도달하지 않습니다. 제로 텔레메트리. |
⌨️ 실제 코딩 에이전트 | 격리된 파일 도구, 통합 diff 승인, 4가지 신뢰 모드, 체크포인트 및 되돌리기(undo), 프로젝트 규칙 (CAELO.md ), 그리고 병렬 서브에이전트 팀을 제공합니다. |
🔎 실시간 검색 및 비전 | 클릭 가능한 인용문이 있는 웹 및 X 검색, 이미지 이해, 문서 Q&A — 실시간 토큰/비용 카운터와 함께 제공됩니다. |
🧩 확장 가능 | MCP 서버(로컬 + 원격), 슬래시 명령어, 훅(hooks), 스킬, 패키지 마켓플레이스, 헤드리스 CLI, 그리고 ACP & LSP를 지원합니다. |
🔄 자동 업데이트 | electron-updater를 통한 델타 업데이트가 가능한 서명된 설치 프로그램입니다.
💬 채팅(Chat) — xAI/Google/OpenAI를 선택하여 대화별로 전환 가능한 스트리밍 멀티 컨버세이션 채팅 기능, 모델 인식 설정, 마크다운 + 코드 지원, 이미지/PDF 첨부 및 비전 기능을 제공합니다. xAI는 실시간 웹/X 검색을 제공하고, OpenAI는 선택적 웹 검색을 제공하며, 음성 액션은 기존의 xAI 서비스를 유지합니다.⌨️ 코드(Code) — 미니 IDE: 파일 트리, CodeMirror 에디터, 터미널, 그리고 파일 도구와 승인 카드(Accept / Reject / Always) + diff 미리보기를 갖춘 에이전트(agent), 체크포인트/실행 취소 기능, 플랜 모드, 프로젝트별 규칙(CAELO.md), 그리고 병합 검토가 있는 **서브 에이전트 팀(subagent teams)**을 지원합니다.🎨 이미지(Image) — 하나의 패널에서 xAI, Google 또는 OpenAI GPT Image를 사용하여 생성 및 편집할 수 있습니다 (참조 없음 → 생성, 참조 있음 → 편집). 모델 인식 크기, 품질, 형식, 배경 및 참조 제어 기능을 제공합니다.🎬 비디오(Video) — 텍스트→비디오 및 이미지→비디오 생성이 가능하며, 편집 및 확장 기능도 지원합니다.🎙️ 음성(Voice) — 말하기(TTS), 전사(STT), 대화(음성 컨버세이션), 실시간(Live) 기능을 제공합니다.🗂️ 기록 및 갤러리(History & Gallery) — 프로젝트별로 범위가 지정된 검색 가능한 아티팩트 및 생성 기록 (SQLite + FTS5). 모드 간에 아티팩트를 전송하고, 클릭 한 번으로 모든 생성 이미지나 비디오 뒤에 있는 프롬프트를 재사용할 수 있습니다.🧩 확장 기능(Extensions) — MCP 서버, 슬래시 명령어, 훅(hooks), 스킬(skills) 및 패키지 마켓플레이스를 지원합니다.
Caelo는 일반 데스크톱 앱입니다. 서명된 .exe 파일에서 설치하고 실행하는 Windows GUI입니다. (설치 프로그램 내부에 Python 백엔드가 번들링되어 있지만, 터미널은 볼 수 없습니다.) 이 앱은 로컬 우선(local-first) 방식이며 어떠한 원격 측정(telemetry)도 전송하지 않습니다 — 분석 엔드포인트, 사용량 보고, 또는 외부 통신을 하지 않습니다. 모델 요청은 선택된 xAI, Google 또는 OpenAI 엔드포인트(사용자 본인의 자격 증명과 함께)로만 전송되며, 선택적 업데이트 확인용으로 GitHub Releases를 이용합니다.
데이터가 저장되는 위치:
You ──▶ Caelo (사용자 PC) ──▶ xAI 또는 Google 또는 OpenAI API (선택된 제공업체)
│
└──▶ GitHub Releases (업데이트 확인 전용 — 건너뛸 수 있음)
- 백엔드는 127.0.0.1 (로컬호스트)에서만 리스닝하며, 네트워크에 노출되지 않습니다. - REST는
Authorization: Bearer <토큰>을 요구합니다.
WebSockets는 쿼리(query)를 통해 토큰을 가져가며, 둘 다 **실패 시 폐쇄(fail-closed)**됩니다. - 제공업체 자격 증명(Provider credentials)은 해당 제공업체의 API로만 전송됩니다. 키와 xAI OAuth 토큰은 기기 운영 체제 자격 증명 시설(operating-system credential facility)으로 암호화되며, 평문 JSON에 저장되지 않으며, 로컬 API를 통해 반환되지 않습니다. - OpenAI 채팅 및 에이전트 요청은 기록을 Caelo가 로컬에서 보관하며, OpenAI의 문서화된 운영/남용 모니터링 보유 정책(operational/abuse-monitoring retention)이 여전히 적용될 수 있습니다. store: false
- 에이전트 파일 작업은 워크스페이스에 **샌드박싱(sandboxed)**됩니다. 쓰기 및 셸 명령에는 **승인(approval)**이 필요하며, 비밀 정보가 없는(secret-free) 환경에서 실행됩니다.
Caelo가 하지 않는 것:
- ❌ 어떠한 종류의 원격 측정(telemetry), 분석 또는 추적도 없음.
- ❌ Caelo 클라우드나 프록시를 사용하지 않음 — 요청은 선택된 xAI, Google 또는 OpenAI API로 직접 전송됩니다.
- ❌ Caelo 계정, 가입, 중개자 부재 — **사용자가 자신의 자격 증명을 가져오는 방식(bring-your-own-credentials)**입니다. - ❌ 채팅, 첨부 파일 및 생성물은 선택된 제공업체가 응답하거나 요청된 미디어를 생성하는 데 필요한 경우에만 사용자의 기기를 떠납니다.
신뢰하지 말고 — 검증하세요. Caelo는 Apache-2.0 하에서 완전한 오픈 소스입니다. 코드를 읽거나 트래픽을 관찰하기만 해도 됩니다: 모델 트래픽은 선택된 xAI, Google 또는 OpenAI 엔드포인트로 직접 전송됩니다.
취약점을 비공개로 보고하세요 — SECURITY.md를 참조하십시오.
사용자 여러분께 — **최신 릴리스(latest release)**에서 플랫폼에 맞는 파일을 다운로드하여 실행한 다음, **설정(Settings)**을 열고 xAI, Google Cloud ADC / AI Studio 키 및/또는 OpenAI API 키를 구성하세요. 그것이 전부입니다.
| 플랫폼 | 파일 | 코드 서명 |
|---|
| Windows 10/11 (x64) | Caelo-Setup-<version>.exe (NSIS 설치 프로그램) | ✅ Authenticode — AuraVix Studio (SimplySign), Certum에 의해 타임스탬프됨 |
| macOS Apple Silicon (arm64) | Caelo-<version>-arm64.dmg | ✅ Developer ID + notarized (Gatekeeper 통과) |
| Linux (x64) | Caelo-<version>.AppImage · caelo-desktop_<version>_amd64.deb | — 서명되지 않음 (Linux 표준; 릴리스의 sha256으로 검증하세요) |
macOS는 Apple Silicon 전용입니다. .dmg
이 클라이언트는 Apple Silicon Mac에서 빌드 및 공증(notarized)됩니다. Intel (x64) 버전은 공개되지 않으며, 네이티브 Python 사이드카를 빌드하고 검증할 수 있는 Intel Mac이 없습니다(이는 docs/plans/PLAN_OTWARTE.md에서 추적됨). Apple Silicon에서는 .dmg를 실행하고; Linux에서는 포터블한 .AppImage(chmod +x 후 실행) 또는 .deb을 설치합니다.
개발자를 위한 방법 — 소스에서 실행하기
요구 사항: Node.js ≥ 20 (v22에서 테스트됨) · Python 3.10+ · 최소 한 개의 제공업체(provider): xAI, Google Cloud ADC / AI Studio 또는 OpenAI API의 자격 증명.
# 1) 백엔드 (caelo_core) — 격리된 venv
cd caelo_core
python -m venv .venv
...
npm run dev는 electron-vite(HMR)를 시작하고, 메인 프로세스는 사이드카를 생성하며, 핸드셰이크(포트 + 토큰)를 읽고 127.0.0.1을 통해 연결합니다. Python은 CAELO_CORE_PYTHON을 통해 위치가 지정됩니다 (env) → caelo_core/.venv/Scripts/python.exe → 시스템 python.
인증 우선순위: OAuth 액세스 토큰 → 저장된 API 키 → .env 파일의 XAI_API_KEY.
패키징 및 자체 점검
# Windows 설치 프로그램 빌드
cd desktop
npm run dist:full # PyInstaller 사이드카 + electron-builder NSIS → desktop/dist/Caelo-Setup-*.exe
...
위 명령어는 Windows 설치 프로그램을 로컬에서 빌드하며(유지 관리자(maintainer)의 SimplySign 인증서로 서명됨), macOS (arm64 dmg, Developer ID + 공증) 역시 Apple Silicon Mac에서 로컬로 빌드됩니다 — docs/guides/MACOS_LOCAL_BUILD.md를 참조하세요.
Linux (AppImage/deb)는 CI(버전 태그 또는 수동 워크플로우 실행)에서 빌드됩니다. 릴리스별 조립 방식은 docs/guides/RELEASING.md를 참조하세요.
Electron (프론트엔드) + Python 사이드카 (백엔드). 성숙한 xAI 로직은 Google REST/ADC 및 OpenAI 응답 어댑터와 공유 모델 역량 레지스트리(shared model-capability registry)와 동일한 경로 뒤에 유지됩니다.
┌──────────────────────── Electron (메인 프로세스) ──────────────────────────┐
│ window, menu, IPC, 사이드카 생명 주기; safeStorage 자격 증명 금고 │
│ 핸드셰이크: 세션 토큰 + 비공개 stdin 비밀 채널; 포트/stdout 읽기 │
...
기여자들을 위한 아키텍처의 진실 공급원(source of truth)은 CLAUDE.md입니다.
사용자 가이드(User Guide)— 모든 모듈을 단계별로 설명합니다.API 레퍼런스(API reference)— 백엔드 REST/WebSocket API (96개 라우트 + 6개 WS).CLAUDE.md— 아키텍처의 진실 공급원 및 강화 이력(hardening history).문서 인덱스(Docs index)·변경 로그(Changelog)·로드맵(Roadmap)
기여는 환영합니다! CONTRIBUTING.md와 CLA, 그리고 행동 강령(Code of Conduct)을 따라주세요.
Caelo는 자유롭고 오픈 소스입니다. 유용하다고 생각되신다면, 개발 지원을 해주실 수 있습니다:
커피 한 잔이 프로젝트 유지 및 업데이트에 도움이 됩니다. 감사합니다! 💜
Apache-2.0 라이선스로 제공됩니다. © 2026 AuraVix Studio.
Caelo는 독립적인 프로젝트입니다.