kh0pper/crow

Crow는 여러분이 이미 사용 중인 서비스 및 AI 도구와 통합되는 모듈형 에이전트 프레임워크 (agentic framework)이자 MCP 플랫폼으로, 로컬 또는 클라우드 모델을 사용하여 여러분이 소유한 하드웨어에서 실행됩니다. 이는 지속적인 메모리 (persistent memory), 리서치, 에이전트 (agents), P2P 공유, 그리고 완전한 셀프 호스팅 앱 생태계를 여러분의 AI 클라이언트가 네이티브하게 접근할 수 있는 하나의 프라이빗 인터페이스로 통합합니다.

개방형 모델 컨텍스트 프로토콜 (Model Context Protocol, MCP) 표준을 기반으로 구축되었습니다. Maestro Press 발행 | 제품 페이지 | 문서

**에이전트 프레임워크 (agentic framework)**로서, 이메일, Discord, 음성을 통해 로컬 및 운영자 제어 방식의 자체 에이전트(Bot Builder)를 구축하고 실행할 수 있습니다. MCP 플랫폼으로서, Crow를 여러분이 이미 비용을 지불하고 있는 AI 클라이언트 (Claude Code, claude.ai, Cursor, opencode)에 네이티브 MCP 서버로 연결할 수 있습니다.

Crow는 여러분의 기존 구독 서비스를 제1급 커넥터 (first-class connector)로 활용합니다. 즉, 클라이언트 대신 실행하는 제3자 하네스 (third-party harness)가 아니라, 지원되는 확장 지점 (extension point)입니다.

두 기능은 동일한 메모리, 프로젝트, 파일 및 기능을 공유합니다. 이메일에서 자율적으로 실행되는 에이전트를 구축하면, Claude Code의 AI 클라이언트가 해당 에이전트가 쌓아온 동일한 메모리에 여전히 접근할 수 있습니다. 이것이 바로 설계 의도입니다: 하나의 기록 시스템 (system of record), 두 가지 접근 모드.

Crow는 오픈 소스입니다. 개발자는 이를 위한 통합 기능, 기술 (skills), 도구 (tools), 패널 및 번들을 구축할 수 있습니다.

여러분의 데이터는 여러분이 제어하는 인프라에 머뭅니다. Crow를 로컬 모델 (Ollama 또는 본인 기기의 모든 OpenAI 호환 엔드포인트)과 결합하면 네트워크 외부로 나가는 데이터는 아무것도 없습니다. 클라우드 어시스턴트 (Claude, ChatGPT, Gemini 등)에 연결하면 여러분이 선택하여 전송하기로 결정한 내용만 여러분의 조건에 따라 해당 제공업체로 전송됩니다. 어떤 방식이든, 기록 시스템 (system of record)은 여러분의 것입니다.

여기서 프라이버시는 단순한 마케팅 용어가 아닌 정직한 가치입니다. 로컬과 클라우드 사이의 선택은 모델별, 사용 사례별로 여러분의 결정에 달려 있습니다. Crow는 결정을 강요하지 않고 두 가지를 모두 지원합니다.

이것은 Crow의 에이전트 프레임워크 측면입니다. Bot Builder가 Crow 에이전트 기능의 핵심입니다. 에이전트(‘봇’)란 페르소나에 사용자가 부여하는 스킬, 도구, 게이트웨이 및 권한을 의미하며, 이를 설정 파일로 직접 수정할 필요 없이 대시보드에서 구성할 수 있습니다.

에이전트 구성하기: 이름과 개성을 부여하고, 모델을 선택하며, 스킬을 연결하고, 사용할 특정 도구를 지정합니다(Crow 자체의 메모리/프로젝트/블로그/스토리지 도구와 설치된 확장 프로그램의 모든 도구 포함). 채널에 배치하기 (게이트웨이): 동일한 에이전트가 이메일(Gmail)로 답변하거나, Discord에서 채팅하거나, 또는 Meta Ray-Ban 글래스에서 빠르고 음성 기반 비서 역할을 수행할 수 있습니다. 하나의 에이전트로 여러 채널을 선택할 수 있습니다. 기본적으로 범위 지정 및 권한 부여: 각 에이전트는 부여받은 도구만 볼 수 있습니다. permission_policy가 요청 없이 할 수 있는 작업을 관리합니다: 행동 전 확인(confirm-before-acting), 명시적 거부(deny outright), 또는 외부 전송 및 게시물을 초안으로 낮추기입니다. 음성 기능은 표면적인 도구 이름뿐만 아니라 기본 동작에 동일한 정책을 적용합니다. 옵트인 자체 작성: 이 기능을 켜면(기본적으로 꺼져 있음), 에이전트는* 자신을 위한 새로운 스킬을 제한된 스테이징 영역에 초안할 수 있습니다. 사용자가 텍스트를 검토하고 대시보드에서 승인하기 전까지는 아무것도 효과가 없습니다. 에이전트가 스스로 도구를 부여하거나 자신의 권한을 완화할 수는 없습니다: 스킬은 프롬프트 텍스트로만 구성됩니다.

호스팅되는 자동 작성 봇 플랫폼과 달리, Crow는 엔진을 사용자의 하드웨어에 유지하며, 에이전트가 스스로 작성하는 모든 것에 운영자 승인 게이트를 두고 있습니다.

기능	제공 사항
지속적 메모리 (Persistent memory)	어시스턴트가 세션과 플랫폼을 넘어 정보를 기억합니다. 전체 텍스트 검색 (Full-text search), 카테고리, 중요도 점수 산정, 자동 회상 (Automatic recall) 기능 제공.
프로젝트 및 연구 (Projects & research)	유형화된 프로젝트 워크플로우, 다중 형식 인용 (APA, MLA, Chicago), 참고 문헌 (Bibliographies), 출처 검증. 모든 주장은 저장된 출처와 연결됩니다.
에이전트 (봇 빌더) (Agents (Bot Builder))	페르소나를 구축하고, 도구와 기술을 부착하여 Gmail, Discord 또는 음성을 통해 실행합니다. 범위가 지정되고 권한이 부여되며, 운영자의 승인을 거칩니다.
암호화된 P2P 공유 (Encrypted P2P sharing)	Crow 사용자 간에 메모리, 프로젝트 및 메시지를 직접 공유합니다. 종단간 암호화 (End-to-end encrypted)를 지원하며, 중앙 서버나 계정이 필요 없습니다.
블로그 및 퍼블리싱 (Blog & publishing)	RSS/Atom 피드, 테마, 공개 URL을 지원하는 마크다운 (Markdown) 블로그. AI에게 말하는 것만으로 게시할 수 있습니다.
파일 스토리지 (File storage)	할당량(Quota) 및 사전 서명된 URL (Presigned URLs)을 지원하는 S3 호환 스토리지.
20개 이상의 통합 (20+ integrations)	GitHub, Slack, Notion, Gmail, Trello, Discord, Google Workspace 등을 포함하며, 하나의 인증된 게이트웨이를 통해 프록시(Proxy)됩니다.
셀프 호스팅 애드온 (Self-hosting add-ons)	Ollama, Nextcloud, Immich, Home Assistant, Jellyfin 등을 지원하며, AI에게 요청하여 설치할 수 있습니다.
멀티 인스턴스 (Multi-instance)	여러 장치에서 Crow를 실행하고, 이동 시 함께 동기화되어야 할 요소들을 동기화합니다.

Crow는 암호화된 피어 투 피어 (Peer-to-peer) 공유 기능이 내장된 최초의 AI 플랫폼입니다. 클라우드 중개자도, 생성해야 할 계정도 없으며, 오직 귀하의 Crow ID만 있으면 됩니다.

Crow는 여러 인스턴스를 하나의 프라이빗 인터페이스로 통합하여 귀하의 장치들을 연결합니다. 오픈 소스 Android 앱이나 모든 브라우저의 대시보드에서 연결된 모든 인스턴스에 접속하고 제어할 수 있습니다.

메모리 및 프로젝트 공유: 메모리 또는 전체 프로젝트 공간을 친구의 Crow로 종단간 암호화 (end-to-end encryption)하여 전송합니다.
프로젝트 공간 협업: 프로젝트 공간에는 멤버, 역할 (소유자 / 편집자 / 뷰어 / 게스트), 그리고 멤버별 권한 재정의 (capability overrides) 기능이 있습니다. 클론 공유 (Clone-share)는 현재 일회성 스냅샷을 제공하며, 실시간 단방향 구독 (live one-way subscription)은 향후 계획된 후속 기능입니다.
암호화된 메시징: Nostr 프로토콜을 통해 발신자의 익명성을 완전히 보장하며 Crow 사용자 간에 메시지를 전송합니다.
오프라인 작동: 공유 대기열이 생성되며, 양측 피어 (peer)가 모두 온라인 상태가 되면 전달됩니다. 피어 릴레이 (Peer relays)가 비동기 전달을 처리합니다.
제로 트러스트 (Zero trust): 중앙 서버는 귀하의 데이터를 볼 수 없습니다. 초대 코드, 안전 번호 (safety numbers), 그리고 전 과정에 걸친 NaCl 암호화가 적용됩니다.

"내 프로젝트를 Alice에게 뷰어로 클론해줘"라고 말하면 끝입니다. Crow가 암호화, 탐색, 그리고 번들 조립을 처리합니다.

더 알아보기: 공유 가이드 (Sharing Guide) · 아키텍처 (Architecture)

동일한 프레임워크가 귀하가 무엇을 하느냐에 따라 매우 구체적인 방향을 제시합니다. 아래의 각 분류는 Crow가 현재 제공하는 기능을 설명합니다.

교육: 학생, 교사 및 연구자를 위한 프라이빗 AI 워크스페이스입니다. Crow는 세션 전반에 걸쳐 귀하의 작업 내용을 기억하고, 정확한 인용 및 참고 문헌과 함께 소스를 관리하며, 강의 도구 및 공개 데이터셋과 연결됩니다. FERPA(가족 교육 권리 및 개인정보 보호법)에 민감한 환경을 위해 구축되었으며, 귀하의 데이터는 귀하가 제어하는 인프라에 머뭅니다.
법률: 법률 업무를 위한 셀프 호스팅 에이전트형 어시스턴트입니다. 사건 정리, 문서 조사, 인용 추적 기능을 제공하며, 특권 자료는 귀하가 소유한 하드웨어에 보관됩니다. 제3자 AI 벤더는 파일을 볼 수 없습니다.
홈 엔터테인먼트: 홈 서버를 미디어를 위한 에이전트형 허브로 변환합니다. 귀하의 라이브러리를 활용하여 안경을 포함한 모든 장치에서 음성 제어로 음악과 비디오를 감상하세요. 귀하의 컬렉션, 귀하의 규칙, 귀하의 습관을 추적하는 것은 아무것도 없습니다.
엔터프라이즈: 규제 대상 데이터를 다루는 팀을 위한 셀프 호스팅 에이전트형 플랫폼입니다.

내부 어시스턴트(assistant)를 구축하고, 팀이 이미 사용 중인 도구들을 연결하며, 에이전트가 수행하는 모든 작업에 대해 운영자 승인 게이트(operator-approval gates)를 설정하여 모든 데이터를 귀하의 자체 네트워크 내에 유지하세요.

Crow는 미들웨어 계층(middleware layer)이나 플러그인 하네스(plugin harness)가 아니라, 귀하가 이미 사용 중인 AI 클라이언트(client)에 네이티브 MCP 서버로 연결됩니다. 한 번 설치하면, 귀하의 AI 클라이언트는 해당 프로토콜을 통해 Crow의 모든 기능 범위를 활용할 수 있습니다.

Claude	ChatGPT	Gemini	Grok	Cursor	Windsurf	Cline	Claude Code
Web, Mobile, Desktop	Apps/Connectors	CLI, AI Studio	Remote MCP	IDE	IDE	VS Code	CLI

다크 에디토리얼(Dark Editorial) 디자인이 적용된 서버 사이드 렌더링(Server-rendered) 웹 UI를 제공합니다. 비밀번호로 보호되는 세션 기반 인증(session-based auth)을 지원합니다. 봇 빌더(Bot Builder), 메시지(Messages), 블로그(Blog), 파일(Files), 확장 기능(Extensions), 설정(Settings)을 위한 내장 패널이 포함되어 있습니다. 서드파티(Third-party) 패널은 ~/.crow/panels/에서 설치할 수 있습니다.

.

Crow's Nest를 채팅 프론트엔드(frontend)로 사용하여 귀하의 AI 제공업체인 OpenAI, Anthropic, Google, Ollama 또는 모든 OpenAI 호환 엔드포인트(endpoint)를 연결하세요. 도구 호출(Tool calling)은 Crow의 MCP 서버를 통해 라우팅되므로, AI가 대화 중에 메모리, 프로젝트 및 파일에 접근할 수 있습니다. API 키는 서버를 떠나지 않습니다.

아래의 CLI 흐름 대신 가이드된 설정을 사용하려면: 첫 실행 마법사(first-run wizard)와 연결 마법사(connect wizard, 설정 → 연결)가 초기 설정 및 첫 번째 AI 클라이언트 연결 과정을 안내하므로 설정 파일(config files)이 필요하지 않습니다.

설정이나 유지보수가 필요 없는 사전 구성된 Crow 인스턴스입니다.

로컬 SQLite를 사용하며 외부 데이터베이스가 필요 없는, 절대 잠들지 않는 영구 무료 서버입니다.

• 무료 Oracle Cloud 계정 생성
• Always Free VM.Standard.E2.1.Micro 인스턴스(Ubuntu 22.04) 실행
• Crow + Tailscale 설치 및 systemd 서비스 생성
• 모든 AI 플랫폼에서 연결

git clone https://github.com/kh0pper/crow.git && cd crow
npm run setup
npm run desktop-config # 출력 내용을 Claude Desktop 설정에 복사

cd crow
npm run setup
claude # .mcp.json + CLAUDE.md를 자동으로 로드합니다

curl -fsSL https://raw.githubusercontent.com/kh0pper/crow/main/scripts/crow-install.sh | bash
crow status

crow CLI를 사용하여 번들(bundle) 및 업데이트를 관리하는 지속적인 서비스로 Crow를 설치합니다. Raspberry Pi, Debian 및 Ubuntu를 지원합니다.

더 많은 경로 (Google Cloud, Docker, 완전한 셀프 호스팅) — 전체 시작 가이드.

Crow는 올인원 셀프 호스팅 (self-hosted) 홈 서버이기도 합니다. 파일 동기화, 사진, 스마트 홈, 미디어, 로컬 AI 등 일반적인 홈 서버에서 사용하는 방식 그대로 앱 스토어에서 앱을 설치하세요. 차이점은 다음과 같습니다: 모든 앱이 번들 (bundle)로 설치되기 때문에, 여러분이 셀프 호스팅하는 것은 단순한 앱이 아니라 여러분의 에이전트 (agents)와 AI 클라이언트 (AI clients)가 사용할 수 있는 하나의 기능 (capability)이 됩니다.

**번들 (bundle)**은 기능의 단위입니다: 서비스, 해당 서비스의 MCP 도구, 그리고 기술 (skills)의 결합체입니다. 한 번 설치하면 Crow를 사용하는 모든 곳—에이전트, 연결된 AI 클라이언트, 그리고 대시보드 (Crow's Nest)—에서 사용할 수 있습니다.

Crow OS는 Raspberry Pi 또는 모든 Debian 머신을 개인용 AI 서버로 변환합니다. crow CLI는 플랫폼과 설치 가능한 애드온 번들 (add-on bundles)을 관리합니다:

• crow status: 플랫폼 상태, ID, 리소스 사용량 확인
• crow bundle install <id>: Ollama, Nextcloud 또는 Immich와 같은 애드온 설치
• crow bundle start/stop/remove: 번들 컨테이너의 생명주기 (lifecycle) 관리

셀프 호스팅 애드온에는 로컬 AI (Ollama), 파일 동기화 (Nextcloud), 사진 관리 (Immich), 스마트 홈 (Home Assistant), 지식 관리 (Obsidian) 등이 포함됩니다.

→ Crow OS 설치 프로그램 (Installer) · 애드온 레지스트리 (Add-on Registry)

Crow는 오픈 소스이며, 개발자들의 참여를 환영합니다 — 생태계를 위한 통합 기능, 기술 (skills), 핵심 도구, 패널, 그리고 셀프 호스팅 번들을 구축해 보세요.

MCP 통합 (Integrations): 새로운 서비스 (Linear, Jira, Todoist 등) 연결
기술 (Skills): AI에게 새로운 워크플로우를 가르치는 행동 프롬프트 (behavioral prompts) 작성 (코드 불필요)
핵심 도구 (Core Tools): crow-memory, crow-projects, crow-sharing, crow-storage 또는 crow-blog에 MCP 도구 추가
셀프 호스팅 번들 (Self-Hosted Bundles): 특정 사용 사례를 위한 Docker Compose 설정 생성

→ 개발자 문서 (Developer Docs) · 커뮤니티 디렉토리 (Community Directory) · CONTRIBUTING.md

전체 문서는 maestro.press/software/crow에서 확인 가능합니다.

• Bot Builder: 페르소나(Persona), 도구(Tools), 기술(Skills), 게이트웨이(Gateways) 및 권한(Permissions)을 갖춘 에이전트 구축
• Meta Glasses: Ray-Ban Meta 안경에서 핸즈프리로 에이전트 실행
• Managed Hosting: 설정이 필요 없는 사전 구성된 Crow 인스턴스
• Platform Guides: Claude, ChatGPT, Gemini, Grok, Cursor, Windsurf, Cline 설정을 위한 가이드
• Integrations: API 키 설정 안내가 포함된 20개 이상의 모든 서비스 연동
• Sharing & Social: P2P 암호화 공유, 메시징 및 협업
• Storage: 할당량(Quota) 및 사전 서명된 URL(Presigned URLs)을 지원하는 S3 호환 파일 스토리지
• Blog: 테마, RSS 및 공개 공유를 지원하는 AI 기반 퍼블리싱
• Crow's Nest: Bot Builder, 메시지, 파일, 블로그 및 확장 프로그램을 위한 패널을 갖춘 웹 UI
• Architecture: 시스템 설계, 서버 API, 게이트웨이 상세 정보
• Skills: AI 워크플로우를 위한 행동 프롬프트 (Behavioral prompts)
• Security: API 키 안전성, 배포 보안 및 키 유출 시 대처 방법
• Troubleshooting: 문제 해결

MIT