CraftBot

CraftBot이란?

CraftBot은 내 PC에서 실행되는 개인용 AI 어시스턴트로, 작업을 해석하고 행동을 계획하며 실행하여 목표 달성을 돕도록 설계되었습니다. 선호도와 목표에 기반해 작업을 주도적으로 계획하고 시작할 수 있도록 지속적으로 작동합니다.

이 프로젝트는 여러 언어 모델 제공자를 지원하며, 통합, 메모리 시스템, MCP(Model Context Protocol)와 커스텀 스킬을 통한 확장 프레임워크를 포함해 에이전트 기능을 확장합니다.

주요 기능

• Bring Your Own Key (BYOK) LLM 제공자 시스템: OpenAI, Google Gemini, Anthropic Claude, BytePlus, 로컬 Ollama 등 지원 LLM 제공자를 선택하고 전환.
• 일일 통합 메모리 시스템: 자정에 하루 이벤트를 요약·통합해 지속적 개인화를 지원.
• 승인 기반 주도적 에이전트 행동: 선호도, 습관, 삶의 목표 학습; 작업 계획 및 시작 가능(워크플로에 승인 포함).
• OAuth 지원 외부 도구 통합: Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram 등 서비스 연결(추가 예정).
• 확장 기능 위한 MCP 통합: Model Context Protocol을 사용해 외부 도구·서비스로 에이전트 기능 확장.
• 스킬 프레임워크: 작업 계획, 연구, 코드 리뷰, git 작업 등 내장 스킬을 가진 확장형 스킬 프레임워크.

CraftBot 사용 방법

1. 필수 조건 설치: Python 3.10+ 사용하고 저장소 클론. 선택 LLM 제공자(OpenAI, Gemini, Anthropic 등)의 API 키 필요.
2. 의존성 설치: 클론한 CraftBot 디렉터리에서 python install.py 실행.
3. 에이전트 시작: python run.py 실행. 첫 실행 시 API 키 설정 안내.
4. 인터페이스 모드 선택:
   • Browser (기본): python run.py (권장; Node.js 18+ 필요).
   • TUI: python run.py --tui (Node.js 불필요).
   • CLI: python run.py --cli.
   • GUI (실험적): python run.py --gui install.py --gui (GUI 모드 전환 시 문제 발생 가능).
5. 상호작용 시작: 자연어로 에이전트와 대화. /help로 사용 가능 명령어 확인. 설정 후 Google, Slack, Notion 등 통합 연결.

사용 사례

• 개인 작업 계획 및 시작: 선호도와 삶의 목표에 맞춰 다단계 작업 계획 및 시작 요청(워크플로에 승인 포함).
• 작업 앱 간 크로스 도구 지원: Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram 등 통합 연결로 여러 서비스 작업 지원.
• MCP를 통한 기능 확장: MCP로 외부 도구·서비스 추가 연결해 내장 기능 외 상호작용.
• 개발자 워크플로 지원: 연구, 코드 리뷰, git 작업 등 내장 스킬로 소프트웨어 작업 직접 지원.
• 환경에 맞는 인터페이스 선택: 웹 인터페이스를 위한 브라우저 모드, 경량 터미널 워크플로를 위한 TUI/CLI, 시각 피드백을 위한 실험적 GUI 모드.

자주 묻는 질문

• CraftBot이 사용할 수 있는 모델은? CraftBot은 OpenAI, Google Gemini, Anthropic Claude, BytePlus, 로컬 Ollama 등 다중 제공자의 BYOK LLM 시스템 지원.

• Node.js가 필요하나요? Node.js 18+는 브라우저 인터페이스에만 선택적; 설치되지 않으면 설치 프로그램이 안내하거나 TUI 모드 사용.

• GUI 모드가 안정적인가요? 아니요—GUI 모드는 실험적이며 에이전트가 GUI 모드로 전환할 때 문제 발생 가능. 프로젝트에서 적극 개선 중.

• CraftBot 기능을 확장할 수 있나요? 네. 저장소에서 MCP 통합과 skills 프레임워크 지원 나열, 에이전트 기능 확장 목적.

• 기본 지원 통합은? Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram 통합 나열, 임베디드 자격 증명 및 OAuth 지원.

대안

• 프레임워크로 구축된 로컬·도구 사용 AI 에이전트: 비슷한 “에이전트가 내 PC에서 실행” 설정을 원하지만 다른 생태계를 선호한다면, 도구 호출·메모리·제공자 전환을 지원하는 프레임워크를 찾아보세요.
• 외부 도구 연결 채팅 기반 어시스턴트: 자율 계획/실행 대신 간단한 채팅과 통합이 목표라면, 연결된 앱과 대화 워크플로에 초점을 맞춘 어시스턴트를 고려하세요.
• 명령줄 생산성 자동화: AI 계획 루프 없이 자동화를 선호하는 사용자에게는, 미리 정의된 워크플로에 따라 작업을 조율하는 태스크 러너와 자동화 도구가 대안입니다.
• MCP 지원 에이전트 설정: MCP로 기능을 확장하는 것이 주 목적이라면, 선호하는 UI와 도구 세트에 맞는 다른 MCP 지원 에이전트 아키텍처나 구현을 비교하세요.