alfredfrancis/ai-chatbot-framework

해결하는 문제

이 프로젝트는 개인용 셀프 호스팅 AI 어시스턴트 환경을 제공합니다. 개인 파일, 커스텀 스킬, 외부 애플리케이션 데이터에 대한 AI 에이전트의 접근을 관리하면서도, 모든 상호작용이 안전하고 격리된 작업 공간 내에서 이루어지도록 보장합니다.

작동 방식

각 사용자에게는 에이전트를 위한 샌드박스 역할을 하는 개인용 Docker 컨테이너가 할당됩니다. 에이전트는 읽기, 쓰기, 편집, bash 명령 실행과 같은 핵심 도구 세트를 사용하여 작업 공간과 상호작용합니다. 에이전트는 읽고 업데이트할 수 있는 일반 텍스트 파일(context.md 및 memory.md)을 통해 자체 메모리와 컨텍스트를 관리합니다. 커스텀 스킬을 업로드하거나, 안전한 인증을 위해 OAuth를 지원하는 Model Context Protocol (MCP)을 통해 외부 서비스를 연결하여 에이전트의 기능을 확장할 수 있습니다.

대상 사용자

자신의 파일과 도구에 지속적으로 접근할 수 있는 개인용 AI 어시스턴트를 원하는 개인, 그리고 다른 앱 및 에디터와의 통합을 위해 Agent Client Protocol (ACP)을 지원하는 에이전트 환경을 직접 호스팅하려는 개발자를 위한 것입니다.

주요 특징

• 개인용 샌드박스: 모든 사용자는 에이전트, 파일, 도구를 위한 전용 격리된 Docker 컨테이너를 제공받습니다.
• 유연한 모델 지원: Claude, OpenAI, Ollama를 통한 로컬 모델 등 LangChain과 호환되는 모든 제공업체와 함께 작동합니다.
• 파일 기반 메모리: 에이전트 메모리와 사용자 컨텍스트에 간단한 Markdown 파일을 사용하여 에이전트가 알고 있는 내용을 쉽게 검토하거나 수정할 수 있습니다.
• MCP 통합: Claude 스타일의 MCP 서버를 지원하여 GitHub, Linear, Notion과 같은 앱과 연결할 수 있습니다.
• 실시간 제어: 에이전트가 작업 중일 때 메시지를 보내면, 에이전트가 이를 현재 작업에 즉시 반영합니다.
• 외부 접근: ACP 호환 WebSocket API를 노출하여 외부 에디터 및 애플리케이션이 에이전트와 상호작용할 수 있도록 합니다.