Ciaobot
<p align="center">
<img src="https://raw.githubusercontent.com/raffaelefarinaro/ciaobot/HEAD/site/assets/img/hero.png" alt="Ciaobot mascot saying Ciao!" width="100%">
</p>
Ciaobot은 사용자가 이미 사용하는 에이전트, Claude Code와 OpenCode를 위한 지속적인 개인 작업 공간이자 두 번째 뇌(second brain) 및 개인 비서입니다.
에이전트가 작업을 수행하고, Ciaobot이 컨텍스트를 유지합니다. Claude Code와 OpenCode는 모델과 도구를 처리하며, Ciaobot은 프로젝트, 영구 메모리(durable memory), 파일, 반복 작업 등을 추가하여 모든 대화가 이전 내용을 기반으로 구축될 수 있도록 합니다.
AI만 바꾸고, 두 번째 뇌는 바꾸지 마세요. Claude나 OpenCode를 클라우드 또는 로컬 모델과 함께 사용하세요. 사용자님의 메모, 프로젝트 컨텍스트, 기억된 선호도는 사용자님이 소유한 폴더에 남아 있습니다. 영구 Markdown 지식은 Ciaobot 외부에서도 유용하게 사용할 수 있으며, 제공자(provider) 세션, 도구 및 권한은 상호 교환할 수 없습니다.
설치 (Install)
macOS 13+ Apple Silicon (M1 이상):
curl -fsSL https://github.com/raffaelefarinaro/ciaobot/releases/latest/download/install.sh | sh
uv를 사용하여 엔진을 설치하고, LaunchAgent로 시작하며, 일회성 링크를 출력합니다. http://localhost:8443을 열고 설정 마법사를 따르세요. 이를 통해 작업 공간을 선택하거나 생성하고, 대시보드 비밀번호를 설정하며, 사용하려는 제공자(provider)를 연결할 수 있습니다.
설정 과정에서 Ciaobot이 메모와 기억을 보관할 폴더를 선택합니다: 새 폴더 또는 Obsidian vault와 같은 기존 폴더입니다. 이 데이터는 사용자님의 것이며, 일반 Markdown 형태로 다른 모든 도구에서 사용할 수 있습니다.
Windows 11 (x64 또는 ARM64), 프리뷰:
irm https://github.com/raffaelefarinaro/ciaobot/releases/latest/download/install.ps1 | iex
관리자 권한이 필요하지 않습니다. 출력된 링크를 열고 설정 마법사를 따르세요. 요구 사항, 설치 옵션, 업데이트, 제거 및 문제 해결은 Windows 가이드를 참조하세요.
에이전트 연결 (Connect your agent)
Ciaobot은 자체 모델 계정을 가지고 있지 않습니다. 대신 사용자가 이미 로그인한 CLI를 구동합니다:
- Claude: Claude Code를 설치하고(
curl -fsSL https://claude.ai/install.sh | bash, 필요하면 ~/.local/bin을 PATH에 추가 후) claude auth login을 실행합니다. Windows의 경우, 대신 irm https://claude.ai/install.ps1 | iex로 설치합니다.
- OpenAI, OpenRouter, Ollama 및 기타: OpenCode 2.0.16+를 설치하고(
npm install -g @opencode/cli; 다른 경로는 INTEGRATIONS.md 참조) 해당 제공업체에서 인증합니다. 이 모델들은 Ciaobot의 모델 선택기(model picker)에 나타납니다.
현재 명령어는 INTEGRATIONS.md를 참고하세요. git 체크아웃으로 작업하는 기여자들: docs/DEVELOPMENT.md.
기존 설치 환경
작동 방식
작업은 워크스페이스 → 프로젝트 → 채팅으로 구성됩니다. 워크스페이스는 자체 메모리를 가진 개인, 업무 또는 클라이언트 등 삶의 큰 영역입니다. 프로젝트는 특정 주제에 대한 배경을 담고 있으며, 채팅은 하나의 과제입니다. 채팅을 완료하면 아카이브하고, Ciaobot이 보관할 가치가 있는 내용은 사용자가 선택한 폴더에 일반 Markdown 형식으로 노트로 정리합니다.
<p align="center">
<img src="https://raw.githubusercontent.com/raffaelefarinaro/ciaobot/HEAD/site/assets/img/home.webp" alt="작업을 시작할 수 있는 상자와 주의가 필요한 채팅이 표시된 Ciaobot 홈 페이지" width="100%">
</p>
프로젝트는 또한 사용자의 기기에 있는 git 저장소와 연결될 수도 있습니다. 그러면 각 채팅은 기본적으로 꺼져 있는 **코드 모드(code mode)**를 갖게 됩니다. 이 모드를 켜면 (사용자가 직접 켜거나, 코드로 작업하라고 요청할 때 에이전트가 켜면), 해당 채팅은 저장소의 AGENTS.md 파일을 따르고, 스킬을 로드하며, 그 안에 내용을 작성할 수 있습니다. 반면에 메모와 결정 사항은 Ciaobot에 보관됩니다.
클릭 가능한 모든 것은 채팅에서도 요청할 수 있습니다.
전체 가이드, 기능, 메모리, 모델 및 원격 액세스: raffaelefarinaro.com/ciaobot.
문서화 (Documentation)
문서 허브(documentation hub)에서 시작하세요. 사용자가 하고 싶은 작업에 따라 정리되어 있습니다:
- Ciaobot 사용: 첫 번째 작업, 프로젝트, 메모리, 파일 및 자동화.
- 연결 및 확장: 프로바이더, Google Workspace, 스킬, 및 MCP.
- Ciaobot 운영: 업데이트, 백업, 원격 액세스 및 문제 해결.
- Ciaobot 구축: 아키텍처, 개발, API 및 에이전트 CLI.
왜 Claude Code나 OpenCode를 사용하지 않을까요?
그것들은 훌륭한 에이전트입니다. 하지만 Ciaobot은 그들에게 영구적인 개인 작업 공간을 제공합니다: 삶의 분리된 영역, 각 대화로 전달되는 프로젝트 컨텍스트, 검토 가능한 메모리, 예약된 작업, 그리고 채팅 옆에서 논의할 수 있는 문서들이 있습니다.
| 영구적인 작업 공간이 없을 때 | Ciaobot 사용 시 |
|---|
| 매 세션마다 동일한 배경 설명을 설명해야 함 | 프로젝트 컨텍스트가 대화와 함께 이동함 |
| ... | |
무엇을 기억했는지 확인하세요. 무엇을 남길지 결정하세요.
Session insights를 활성화하면 채팅을 보관할 때 확정된 사실은 자동으로 파일로 저장되고, 불확실한 내용은 제안으로 남습니다. Memory에서 제안과 기록된 결정을 검토하고, 되돌릴 수 있는 영수증이 제공되는 Undo 기능을 사용할 수 있습니다. Nightly curation은 새로운 핵심 사실을 임의로 추가하기보다 기존의 핵심 기억을 통합합니다. 오래되거나 사용하지 않는 노트는 자동으로 삭제되지 않고 플래그가 지정되어 사용자 결정에 맡겨지며, 은퇴된 노트는 영구적으로 삭제할 때까지 복원 가능하게 유지됩니다.
사용자에게 제공되는 제품은 Ciaobot입니다. CLI는 ciaobot과 ciao 두 가지 이름으로 설치되며, Python 패키지와 많은 환경 변수는 호환성을 위해 여전히 ciao/CIAO_*를 사용합니다.
기반 기술
