현대의 학습 환경에서 우리는 점점 더 많은 정보와 도구를 활용하여 공부하고 있습니다. 하지만 그만큼 혼란도 커지고 있는데요, 개별 학습자의 필요를 충족시키고 효율성을 높여주는 도구가 필요합니다. 그런 점에서 주목할 만한 프로젝트가 바로 Clicky입니다. Clicky는 화면 옆에서 사용자와 상호작용하며, 질문에 답하고 필요한 정보를 제공하는 AI 튜터입니다. 이 포스팅에서는 Clicky의 주요 기능, 설치 방법, 활용 시나리오를 자세히 살펴보겠습니다.

Clicky의 주요 기능과 특징

Clicky는 단순한 챗봇이 아닙니다. 다음과 같은 다양한 기능을 제공합니다:

  1. 실시간 상호작용: Clicky는 사용자의 화면을 보고, 질문을 이해하며, 적절한 정보를 찾아 제공합니다.
  2. 음성 인식 및 출력: 사용자가 말하는 내용을 인식하고, 음성으로 대답합니다. 이는 더 자연스러운 학습 경험을 제공합니다.
  3. 프라이버시: Cloudflare Worker를 통해 API 키를 안전하게 관리하므로, 민감한 정보를 별도로 보호할 수 있습니다.
  4. 확장성: 오픈소스 프로젝트로 제공되므로, 개발자가 원하는 기능을 추가하거나 수정할 수 있습니다.

    5. Clicky 설치 및 기본 사용법

    1. 필수 조건

    Clicky를 사용하기 위해서는 다음과 같은 환경이 필요합니다:

    • macOS 14.2 이상 (ScreenCaptureKit 필요)
    • Xcode 15 이상
    • Node.js 18 이상 (Cloudflare Worker를 위해)
    • Cloudflare 계정 (무료 계정 가능)
    • 다음 API 키:

      • - Anthropic - AssemblyAI - ElevenLabs

      2. Cloudflare Worker 설정

      Cloudflare Worker는 API 키를 안전하게 저장하고 관리하는 데 사용됩니다. 다음 단계를 따라 설정해 보세요:

      cd worker
npm install

      이제 비밀 키를 추가합니다. Wrangler가 각 키를 입력하라고 요청합니다:

      npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler secret put ASSEMBLYAI_API_KEY
npx wrangler secret put ELEVENLABS_API_KEY

      ElevenLabs의 음성 ID는 wrangler.toml 파일에 추가합니다:

      [vars]
ELEVENLABS_VOICE_ID = "your-voice-id-here"

      Worker를 배포합니다:

      npx wrangler deploy

      배포가 완료되면 https://your-worker-name.your-subdomain.workers.dev와 같은 URL이 생성됩니다. 이 URL을 복사해둡니다.

      3. 앱의 프록시 URL 업데이트

      Clicky 앱 내부에서 Cloudflare Worker URL을 사용해야 합니다. 아래 명령어로 해당 문자열을 검색하여 업데이트합니다:

      grep -r "clicky-proxy" leanring-buddy/

      주로 아래 파일에서 수정할 수 있습니다:

    • CompanionManager.swift — Claude 채팅 및 ElevenLabs TTS
    • AssemblyAIStreamingTranscriptionProvider.swift — AssemblyAI 토큰 엔드포인트

      • 4. Xcode에서 열고 실행하기

      Xcode에서 프로젝트를 열고 실행합니다:

      open leanring-buddy.xcodeproj

      Xcode에서 leanring-buddy를 선택하고 빌드한 후 실행합니다.

      실제 활용 시나리오

      Clicky는 다양한 상황에서 유용하게 사용될 수 있습니다. 예를 들어, 학생들이 학습 중 질문이 생길 때 Clicky에게 질문을 던짐으로써 즉시 답변을 받을 수 있습니다. 또한, 프로그래밍을 배우는 사람이라면 코드 작성 중 발생하는 오류를 Clicky에게 물어보는 방식으로 문제를 해결할 수 있습니다.

      비슷한 도구로는 Google Assistant나 Siri와 같은 AI 비서가 있지만, Clicky는 학습에 특화된 기능을 제공하므로 보다 나은 학습 경험을 제공합니다.

      추천 대상

      Clicky는 다음과 같은 사용자에게 추천합니다:

    • 학생: 학습 효율성을 높이고자 하는 학생들에게 적합합니다.
    • 개발자: 코드 작성 중 도움을 받고 싶은 개발자들에게 유용합니다.
    • 자기주도 학습자: 혼자서 공부하는 데 필요한 지원이 필요한 사람들에게 좋습니다.

Clicky를 통해 학습 문제를 해결하고, 더 나은 학습 환경을 만들어보세요. 오픈소스 프로젝트인 만큼 자유롭게 수정하고 활용할 수 있습니다.

자세한 내용은 GitHub 페이지에서 확인하세요: farzaa/clicky