csr1010/wappy-kit

어떤 프로젝트인가요?

핵심 기능

• 01`npm create` 명령 하나로 WhatsApp 에이전트 프로젝트를 생성합니다.
• 02직접 준비한 키를 사용해 Anthropic, OpenAI, Gemini, 로컬 Ollama 모델을 지원합니다.
• 03대화와 가져온 지식을 기본적으로 SQLite/LibSQL에 로컬 저장합니다.
• 04선택 사항으로 셀프 호스팅 또는 클라우드 지식 그래프 백엔드인 Cognee를 제공합니다.
• 05읽기 전용 Gmail 및 Google Calendar 도구 예제를 포함합니다.

활용 사례

• WhatsApp 대화 전반의 맥락을 기억하는 비공개 개인 비서를 만듭니다.
• 메모나 문서를 서드파티 클라우드로 보내지 않고 내용을 바탕으로 질문에 답합니다.
• WhatsApp에서 이용할 수 있는 고객 지원 또는 예약 봇을 프로토타이핑합니다.
• 로컬 Ollama 모델을 사용해 완전히 오프라인으로 에이전트를 실행합니다.

빠른 시작

1. 1

   설치 프로그램으로 프로젝트를 생성합니다

   npm create @wappy_ai/agent
2. 2

   env 샘플을 복사한 뒤 모델 API 키와 WhatsApp 자격 증명을 입력합니다

   cp .env.sample .env
3. 3

   의존성을 설치합니다

   npm install
4. 4

   개발 서버를 시작하고 터널을 연 다음, 출력된 URL을 Meta의 웹훅으로 설정합니다

   npm run dev

사용 전 알아둘 점

• !프로젝트는 아직 1.0 이전 버전이며 초기 단계이므로 변경될 수 있습니다.
• !Node.js 22 이상과 Meta의 WhatsApp Cloud API 앱이 필요합니다.
• !에이전트를 실행하려면 직접 발급받은 모델 API 키나 로컬 Ollama 환경이 필요합니다.

토픽

자주 묻는 질문

wappy-kit은(는) 무엇인가요?

자체 모델 키와 데이터를 사용해 WhatsApp에서 실행되는 셀프 호스팅 AI 에이전트를 만드는 오픈소스 TypeScript SDK입니다. Wappy는 공식 WhatsApp Cloud API를 통해 WhatsApp 사용자와 대화하는 AI 에이전트를 만들기 위한 TypeScript SDK이자 프로젝트 생성 도구입니다. `npm create @wappy_ai/agent`를 실행하면 에이전트 루프, 메모리, 도구 호출, 응답 형식 처리가 연결된 프로젝트가 생성되며, Anthropic, OpenAI, Gemini 또는 로컬 Ollama 모델의 키는 직접 준비해야 합니다.

wappy-kit은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

wappy-kit은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

wappy-kit은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. wappy-kit의 마지막 커밋은 2026년 10월 21일입니다.

wappy-kit은(는) 어디에 사용할 수 있나요?

WhatsApp 대화 전반의 맥락을 기억하는 비공개 개인 비서를 만듭니다. 메모나 문서를 서드파티 클라우드로 보내지 않고 내용을 바탕으로 질문에 답합니다. WhatsApp에서 이용할 수 있는 고객 지원 또는 예약 봇을 프로토타이핑합니다. 로컬 Ollama 모델을 사용해 완전히 오프라인으로 에이전트를 실행합니다.

wappy-kit는 어떻게 설치하나요?

설치 프로그램으로 프로젝트를 생성합니다: npm create @wappy_ai/agent env 샘플을 복사한 뒤 모델 API 키와 WhatsApp 자격 증명을 입력합니다: cp .env.sample .env 의존성을 설치합니다: npm install 개발 서버를 시작하고 터널을 연 다음, 출력된 URL을 Meta의 웹훅으로 설정합니다: npm run dev

wappy-kit은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/csr1010/wappy-kit